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Your Shopping Cart 

Listed below is your current shopping cart 

• Review the contents ol your cart. 

• To uetete an Hem click on the name and change the quantity to zero 

• To change the quantty cick the lem name 

• To complete your order cfkd the Check Out' Button 

























































































































































































































Microsoft 

Visual Tools 

Community 


Latest Technology 

integration 

Teamwork 

Components 

Enterprise 


your developers, 



Why is it that the people who come to you with big plans 
have no idea how long it takes to implement them? But 
development professionals like you are more realistic. 
You know that robust enterprise solutions take time. But 
you still need to meet your deadlines and stay sane. 

Now you can, thanks to the Microsoft® Visual Basic® 
4.0 Enterprise Edition development system - the 
first completely RAD tool for distributed client/server 
development. Remote Automation Technology lets you 
dynamically deploy partitioned applications across 
networks. Which reduces maintenance, increases code 
reuse, and helps you deliver more robust enterprise 
applications in less time. 

And, since Visual Basic is an open development 
system, supported by Microsoft Enterprise Development 
Partners, you will have plenty of options. Like tools for 
data, object, and process modeling, as well as application 
testing, maintenance, and bug tracking. Tools that 
are tightly integrated with the same familiar language 
used by more than three million developers 


© 1996 Microsoft Corporation. All rights reserved. Microsoft and Visual Basic are registered trademarks 
and Where do you want to go today? is a trademark of Microsoft Corporation. •Otter good through 
November 30,1996. In Canada call (800) 563*9048; outside the U.S. contact your local subsidiary. 



The RAD tool for the enterprise. 

http: //www. microsoft.com/vbasic/ 

worldwide. Not some proprietary language known only 
to a select few. 

Still, you might be skeptical. So give our Visual Basic 
Web site a whirl at http://www.microsoft.com/vbasic/ 
Or call us today at (800) 228-6139,* Dept. A586, in 
the fifty United States for more information. You may 
not need a rescue. But with Visual Basic, and the tools 
you’ll find from our Enterprise Development Partners, 
you’ll get a leg up on development. 

Microsoft 

WHERE DO YOU WANT TO GO TODAYI 
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GOAL-DIRECTED SOFTWARE DESIGN 

by Alan Cooper 

Goal Direction is the design methodology GUI guru Alan Cooper devised to cut through 
the confusion surrounding software-design problems. Using examples from his own 
design projects, Alan shows how Goal Direction lets you synthesize solutions that would 
otherwise never have been possible. 

CUSTOMIZING THE EXPLORER OPEN DIALOG 

by Al Williams 

Windows 95 uses a special open dialog that allows users to rename files, create 
directories, and (of course) open files. Al shows how to customize this dialog, using a 
Delphi 2.0 component. 

CREATING SHAPED UI OBJECTS 

by Steve Sipe 

CSbape, the C++ class Steve presents here, lets you create and manage custom windows, 
custom controls, and shaped dialog boxes. He then uses the class to build sticky-note 
and stellar calculator user interfaces. 

WRITING USER-DEFINABLE GUIs 

by Troy A. Schauls 

User-defined screens let users create and modify data-entry screens. This ability is 
possible if you use Visual Basic forms that are created, parsed, and compiled into a 
proprietary format, with only a “system form” in the app’s executable file. 

THE JAVA ABSTRACT WINDOW TOOLKIT 

by Anil Hemrajani 

Anil examines the Java Abstract Window Toolkit (AWT), a portable GUI class library for 
developing applications and applets. He then builds a text-editor application for 
Windows 95 and Solaris, along with an applet for Windows 95. 

DATA COMPRESSION WITH THE BURROWS WHEELER TRANSFORM 

by Mark R. Nelson 

The Burrows Wheeler Transform is an algorithm that takes a block of data and 
rearranges it using a sorting algorithm. The resulting output block is extremely 
well-suited for compression. 
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EMBEDDED SYSTEMS 

A PROCESS GROUP MANAGER FOR OS-9 52 

by Peter C. Dibble 

This file manager lets you adapt the OS-9 real-time operating system’s I/O system to 
provide non-I/O services. 

NETWORKED SYSTEMS 

IMPLEMENTING A WEB SHOPPING CART 64 

by Chris Baron and Bob Weil 

Our authors examine the components of an online catalog, focusing on a virtual 
shopping-cart system and ways around the shortcomings of HTTP. They then present an 
online-catalog system implemented in Perl. 
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EXAMINING THE INSTALLSHIELD SDK EDITION 70 

by Joseph Hlavaty 

Joe builds a standardized installation/distribution methodology using the InstallShield 
integrated installation/distribution program, versions of which are included with Visual 
C++ 4.1, Visual Basic 4.0, Borland C++ 5.0, Delphi 2.0, Paradox 7.0, and Optima++. 
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PROGRAMMER'S WORKBENCH 


JAVA, JFACTORY, AND NETWORK DEVELOPMENT 78 

by Eldon Metz 

JFactory is a cross-platform screen painter, prototyper, and code generator for Java that 
lets you concentrate on the design and functionality of your GUI by generating AWT 
source code. Eldon uses it to build an Internet-based client/server Java application. 


FORUM 


EDITORIAL 6 

by Jonathan Erickson 


COLUMNS 

PROGRAMMING PARADIGMS 88 

by Michael Swaine 

Michael strides forth into the field of software design. 

C PROGRAMMING 92 

by Al Stevens 

This month, Al answers the fundamental C++ programming questions he posed 
in August. 


LETTERS 8 

by you 

SWAINE’S FLAMES 128 

by Michael Swaine 

PROGRAMMER'S 

SERVICES 


OF INTEREST 119 

by Monica E. Berg 


JAVA Q&A 101 

by Cliff Berg 

What do you do if the Java AWT’s layout managers won’t let you build the kind of UI 
you need? You write your own layout manager, of course, and Cliff shows you how. 

ALGORITHM ALLEY 107 

by Edward Sitarski 

To overcome the limitations of variable-length arrays, Edward created a data structure 
that has the fast constant-access time of an array, but avoids copying elements when it 
grows. He calls this structure a “Hashed-Array Tree” (HAT) because it combines some of 
the features of hash tables, arrays, and trees. 

UNDOCUMENTED CORNER 112 

by Robert R. Collins 

How does your program know which Intel processor is the current system CPU? Robert 
looks at the options, including Intel’s PUSHF/POPF technique. 

PROGRAMMER’S BOOKSHELF 117 

by Lou Grinzo 

Windows 95 is Lou’s focus this month, as he examines Migrating to Windows 95: 

Programmer's Guide to What’s New, by Mark Andrews, and Programming Windows 95, 
by Charles Petzold and Paul Yao. 


SOURCE CODE 
AVAILABILITY 

As a service to our readers, all source 
code is available on a single disk and 
online. To order the disk, send $14.95 
(California residents add sales tax) to Dr. 
Dobb’sJournal, 411 Borel Ave., San 
Mateo, CA 94402, call 415-655-4100 x5701, 
or use your credit card to order by fax, 
415-358-9749. Specify issue number and 
date. Code is also available through the 
DDJ Forum on CompuServe (type GO 
DDJ), via anonymous FTP from site 
ftp.mv.com (192.80.84.3) in the /pub/ddj 
directory, on the World Wide Web at 
http://www.ddj.com, and through DDJ 
Online, a free service accessible via direct 
dial at 415-358-8857 (14.4 kbps, 8-N-l). 
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From STL and patterns, to C++ and Java, 
object-oriented programming is our focus 
in October. 
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There Is Only One Choice for Data Compression. 
PKZIPfor Windows 



New Features in 

PKZIP for Windows Version 2.50 

► Ability to create .ZIP files that span multiple diskettes 

► Create Windows self-extractor 


► Self-extractor can span multiple diskettes 

► Long file name support for Windows 95 (16 and 32-bit) and 
Windows NT (32-bit) 

[ ► Integration with Windows 95 & NT Explorer 
► Plus additional features 

Why use PKZIP for Windows? 

► Save on-line time charges and disk space 
► Compress files an average of 50-70%; many large files compress well 
over 90% 

► Open .ZIP archives downloaded from the Internet 
>- Simple point-and-click interface 

► Combines the best and fastest patented compression technology found in 
PKZIP 2.04g 

► Compatible with Windows 3.1, Windows 95 & Windows NT 


PKZIP for Windows $49, PKZIP for DOS $47 plus shipping and handling. 

Other PKWARE Products; 

PKLITE and PKLITE Professional* for Windows 

Put your executables on a diet! 


PKWARE Data Compression Library * 

Put compression in your application. Separate versions available for DOS, DOS32, 
Windows, Win32, OS/2, UNIX & Macintosh. 


To order call (414) 354-8699 
or visit our Web Site http://www.pkware.com 


mmL 

The Data Compression Experts® 

9025 N. Deerwood Drive / Brown Deer. Wl 53223 USA 
FAX: 414-354-8559 BBS: 414-354-8670 
Email: info@pkware.com WWW: http://www.pkware.com 



1992-1996 PC World World Clots Award 
1996 Govtrnment Computer Newt 

Best New Product Award at FOSE Finalist 
1995 Computtr Currents Readers Choice Award 
1993 Shareware Industry Award 
1992 Premiere Computing Magailne Award 
1992 Dvorak/Zoom Award 
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Copyright 19% PKWARE. Inc. All Rights Reserved. All trademarks or registered trademarks are the property of their respective owners. DD-996 
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How to get your Windows NT 
applications clean* 



" have pizza delivered and eat while you ivork..." 



INTRODUCING PURIFY FOR WINDOWS NT 
The fastest way to clean your applications. 


In today's complex development environment, eliminating 
memory usage errors can be exceptionally difficult and time 
consuming. That's why we developed Purify. Using our patented 
Object Code Insertion (OCI) technology. Purify 
locates a broad range of run-time errors and 


memory leaks quickly and easily. Just point Purify at your app 
and run it. You'll find that Purify is not only easy to use, but it is 
also incredibly fast. Much faster than any product of its kind. So 
with Purify you can spend more of your time 
working on features, not fixes. 


SOFTWARE 


visit http:llwww.pure.com 

Coll 1-800-353-7873 or email to: info-ddn@pure.com and receive more information or your free evaluation. 


Europe: Pure Software B.V., Tel: +31 23 569 4390, email: info@europe.pure.com 


Asia Pacific: Pure Software K.K., Tel: +81 3 3863 9283, email: info@japan.pure.com 


O 1996 Pure Software, the Pure Software logo and Purify are U.S. registered trademarks of Pure Software Inc. Any other names used herein are registered trademarks of their respective companies. 




EDITORIAL 


Letters, We Get 
Letters... 


B t was a pleasant surprise to open the mail and read that Donald Knuth, author of the three- 
volume The Art of Computer Programming, is the recipient of the Inamori Foundation’s 1996 
Kyoto Prize in the category of Advanced Technology. Considering that a check for $460,000 
accompanies his wall plaque, Dr. Knuth is probably more pleased than I. 

According to Kazuo Inamori, president of the Inamori Foundation and chairman of Kyocera, 
Knuth was given Japan’s highest private award for his contributions to the betterment of 
humankind. In addition to The Art of Computer Programming, Knuth (who was featured in an 
April 1996 DDJ interview) is the creator of the TeX document-preparation system, Metafont font- 
design system, and LR parser and attribute grammar. TeX has been described as the most 
important achievement in publishing since Gutenberg’s moveable type. 

Previous Kyoto Advanced Technology laureates include John McCarthy of artificial-intelligence 
fame, and George Gray, developer of the liquid-crystal display. Please join me in hearty 
congratulations to Dr. Knuth. 

Sometimes, of course, it doesn’t pay to open the mail. Thousands of software houses recently 
found this out upon receiving a letter from E-Data, which owns a patent (*4,528,643) covering 
on-demand electronic distribution of software, fonts, images, music, video, news stories, and just 
about anything else you can think of. In a carrot-and-stick “amnesty’’ offer, E-Data offered 
developers and content providers the choice of a “low-cost, sliding-scale” license or a lawsuit. 
(E-Data sued 18 companies in August 1995 for unspecified infringement.) After skirmishing in 
court, IBM and Adobe licensed the patent (which was granted in 1985 and purchased by E-Data 
in 1995). CompuServe, Ziff-Davis, and other companies are still litigating. E-Data recently was 
ordered to identify each product or service it contends infringes on the patent, and explain the 
meaning of unique technical terms. 

We get our share of menacing missives, too. On the eve of putting ink to paper last month, we 
received a letter from attorneys for Syncronys Softcorp, developer of the SoftRAM compression 
program. The letter, which was standard in its wording, put DDJ “on notice that if there is 
anything in the article [“Inside SoftRAM 95,” by Mark Russinovich, Bryce Cogswell, and Andrew 
Schulman] that is false, defamatory, misleading, or misuses trade secrets or copyright material” the 
company would “vigorously protect its rights.” 

What was surprising about the letter was that we received it before the article went to press. A 
miffed Syncronys CEO Rainer Poertner told PC Week Online that he was “disturbed that things have 
been written without calling us,” as if it is common for computer magazines to get a company’s 
approval before publishing an article about its products. (Well, maybe it is with some publications, 
but not here.) In any event, I’m assuming that the letter was an honest attempt to encourage fair play. 

Letters like the one we received are apparently becoming commonplace. Television-station 
managers, for instance, have received menacing letters warning that “you leave yourself and your 
station exposed to legal action” for broadcasting ads that criticized certain current members of 
Congress. The letter, which raises the specter of libel suits, has been described by First 
Amendment expert Floyd Abrams as “preposterous legally.” 

Interestingly, historians and archivists are pondering how the shift from paper letters to e-mail 
will affect the archives of tomorrow. “People have a strong connection and reaction to paper,” 
says Mary Lynn Ritzenthaler, who supervises document conservation at the National Archives. “It’s 
everything that is extremely common and everyday, and that makes it a real link to history.” Frank 
Romano, professor of electronic publishing at the Rochester Institute of Technology, concurs: “I’ve 
read the letters of F. Scott Fitzgerald to Ernest Hemingway. What are we going to have in the 
future? The e-mail of F. Scott Fitzgerald?” 

Admit it. Doesn’t seeing the Gutenberg Bible, Magna Carta, or John Lennon’s doodling on exhibit 
at the British Museum give you the flutters? You have to wonder how researchers, archivists, and 
museum goers a hundred years from now will react to whatever it is they’re looking at. 

Of course, there are times when you wish all forms of communication—paper or pixels— 
would simply disappear. If you don’t think so, ask the dean of libraries at the University of 
Kansas, who published a summary of two conferences in the May 9th edition of a university 
newsletter, stating that he had “returned reinvigorated.” Unfortunately, the conferences he was 
writing about weren’t held until May 13-18 and May 18-21. The embarrassed administrator 
apologized to his staff, explaining that the draft, written and stored on computer prior to his 
attending the conference, was mistakenly assumed to be the final article. His apologies were sent 
via e-mail, of course. 



editor-in-chief 
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MOTOROLA. HP. SUN).© COPYRIGHT 1995 ZINC SOFTWARE INCORPORATED ALL RIGHTS RESERVED. ALL TRADEMARKS AND TRADENAMES USED HEREIN ARE OWNED BY THEIR RESPECTIVE COMPANIES. 


ZINC APPLICATIONS RUN ON: MS-DOS (GRAPHICS & TEXT) MS-DOS/V (GRAPHICS & TEXT). NEC PC9800 (GRAPHICS & TEXT). MS WINDOWS 
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A few words from our competitors: 


Prtablty. 

Prtbilty. 

Portblty. 

Portabit. 


PCWEEKLABS 

ANALYST’S 

Choice 

r ^ JAM. 30.1995 


INFOWORLD 

February 6. 1995 


"Developers seeking easy delivery of 
GUI applications on DOS. Windows. 
OS/2. Macintosh and Unix platforms, 
or pursuing international markets will 
find Zinc their best option by far ." 

“Zinc came closest of all the 
products we tested to our ideal of 
portability: Just copy the code to the 
target machine, then recompile and 
relink the application... 

In short. Zinc did a great job." 


No matter how they misspell it, it’s still not 
portability. At Zinc, we understand that porting 
the last 20 % of your code takes 80 % of your time. 

Only Zinc offers complete portability. 

With Zinc® Application Framework you can 
develop on the platform you prefer. And since 
Zinc is the only one that delivers I 00 % portability, 
you'll have your application on other platforms as 
fast as you can recompile. It’s part of what makes 
Zinc the most productive—and affordable—tool a 
programmer can use. 

Productivity that leads to opportunity. 

Portability is just one road you’ll find a little 
easier. Zinc zips through tedious tasks with C + + 
object orientation and a unique visual develop¬ 
ment tool. Globalizing your application is as easy 
as translating the text. And Zinc is the only prod¬ 
uct that supplies I 00 % of the source code. 

It all adds up to productivity. Which means 
more profitability. Which is a concept we proba¬ 
bly don’t have to spell out for you. For free infor¬ 
mation and demonstration software, call toll-free: 

800 638 8665 

Outside the U.S. call: +1 801 785 8900. In Europe call: 

*44 (0)181 855 9918. In Asia: *81 (052) 733 4301. Contact Zinc 
electronically at info@zinc.com or GO ZINC on CompuServe. 
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LETTERS 



Why our Windows don't Open 

Dear DDJ , 

I am perhaps DDJ's least-knowledgeable 
reader. I write some AppleScripts, and I 
am learning a bit of C. Still, I enjoy your 
magazine very much. Michael Swaine’s 
“Programming Paradigms” of December 
1995 discussed little languages available 
for the Macintosh, including the Chip¬ 
munk Basic interpreter, whose programs 
can be run by an AppleScript DoScript 
command. I downloaded Chipmunk, 
bought a lxx)k on Basic for a quarter, and 
carefully copied its ten-line sample pro¬ 
grams, which I executed from Apple’s 
script editor. 

Will DDJ's editorial staff throw itself 
from a window upon hearing that the 
magazine has a reader at this level? 

Frisco Del Rosario 

Belmont, California 

Frisco_Del_Rosario@iacnet.com 

The Virtues of Assembler 

Dear DDJ, 

I just received my June 1996 issue of DDJ 
and immediately turned to the “Letters” 
section because I look forward to the in¬ 
formation and code segments other read¬ 
ers send in. For some reason, Pat Farrell’s 
letter on the future of programming caught 
my eye, and I very carefully reread it. 

I must admit that I find it hard to be¬ 
lieve that Pat has been programming for 
the last 20 years. His opinion regarding 
core and memory dumps reminds me of 
die unrealistic expectations of some of my 
fellow students in my first-year program¬ 
ming classes. Likewise, his opinion re¬ 
sembles that of some language zealot who 
continuously states that “such and such 
language solves all programming errors.” 

I work as a contract programmer. I usu¬ 
ally am required to work in Visual Basic 
and AccessBasic because that’s what my 
customers bought, before I was contract¬ 
ed! When I do get a chance to write us¬ 
ing a language such as C/C++ or Delphi 
with built-in debugging tools that are 
available, I rejoice. I rely heavily on my 


debuggers, code profilers, and CASE tools. 

I prefer writing in Delphi or C++, but if 
I need the speed that assembler will give, 

I use assembler. I could not imagine try¬ 
ing to rely solely on the built-in opti¬ 
mization in Delphi, although I admit that 
it is, in a generic way, pretty good. As 
for expecting it to fully optimize my 
code for the 385/486/Pentium, I’m not 
that much of a fool. I suggest that Pat 
might gain a better understanding of 
why I hold this opinion if he were to 
buy and read Michael Abrash’s book 
Zen of Code Optimization (Coriolis 
Group Books, 1994). 

I think that Pat is right that the next gen¬ 
eration of CPU designs will increase the 
demand for optimizing compilers. How¬ 
ever, I expect that, given the ever- 
increasing lag between CPU features and 
software utilization of those features, hand- 
optimizing assembly code will continue 
to be the normal way to achieve the high¬ 
est levels of optimization. 

Derek A. Benner 

Citrus Heights, California 

Cryptic Noise 

Dear DDJ 

Cryptography is becoming ubiquitous in 
our communications; as die numlier of com¬ 
mercial transacdons dirough die Internet in¬ 
creases, more people use cryptography as 
a standard component in many programs. 

There is a problem, however. Public-key 
schemes in use (for example, random keys 
generated for secure HTTP connections, 
or die proposed SSH, Secure Shell, remote 
login protocol) rely heavily on the quali¬ 
ty of the random-number generators from 
which the keys are derived. 

You can use a key as big as you want; 
if your source for key generation defines 
a smaller key space, your key becomes 
as small as the set of random numbers 
you can generate. This means that current 
usage of strong cryptography algorithms 
doesn’t ensure adequate security; currendy, 
a developer using a cryptography library 
must be able to use a good enough ran¬ 
dom-number source, and so, every pro¬ 
gram using random-generated keys should 
document die random-number source. 

As an example, there has been a lot of 
coverage on a problem discovered in the 
key generation method of the Netscape 
Navigator, and more problems will arise 
as more programs are studied. 

I think diere’s only one solution, and I 
think it can be done quite cheaply— 
a hardware random-number generator. 
Given a reasonably good analog noise gen¬ 
erator and a method of sampling it, it 
will always be better than a pseudo- 
random-number generator based on die PID 
of a program, time since last relxxit, current 


Ume, a hash applied to die name of die user, 
and any of diose predictable sources. This 
will lie coasidered a mandatory component 
for computers in some years. 

Borja Marcos 
Spain 

borjam@we.lc.ehu.es 

Patents and the Web 

Dear DDJ 

Has anybody considered the legal impli¬ 
cations of LZW and the GIF format diat is 
built into Java. I remember the issue of 
LZW, CompuServe, and Unisys was un¬ 
der discussion in DDJ a year or two ago 
and there was a lot of talk in the indus¬ 
try of replacing GIF widi a new format. It 
would be interesting to know how all diis 
applies to Java. Sun obviously does not 
require a license from Unisys for Java, 
since Java is free. However, if I write an 
application with Java, which I sell com¬ 
mercially (say, it is a development tool), 
do I then require a license for LZW, since 
any developers using my tools have the 
ability to read GIF images and, indirectly, 
1 sold them the software that has this abil¬ 
ity. I contacted Unisys about clarification 
on this point, but have not been able to 
get any information out of them for the 
past two weeks! 

Piet Obermeyer 
Atlanta, Georgia 
pieto@atlanta .com 

It's a Date 

Dear DDJ 

I decided to subscribe to DDJ on the 
strength of your April 1996 issue. I have 
three comments relevant to the “Letters.” 

• I didn’t read the Homer Tilton calendar 
algorithm. I have saved for 13 years a 
copy of Gordon King’s code for the con¬ 
version of calendar date to Julian date 
(DDJ , June 1983) and for 28 years Hen¬ 
ry Fliegel and Thomas VanFlandern’s 
code for the same purpose published 
in Communications of the ACM, Octo¬ 
ber 1968. The latter was interesting be¬ 
cause it accomplished the conversion in 
one Fortran statement, allowing it to be 
used as an arithmetic statement func¬ 
tion. It is long but it worked: JD{IJ,K)= 
K- 32075 +1461 *(/+ 4800 +(/-l4)/12) 
/4 + 367*(/-2-(/-l4)/12*12)/12- 
3*(/+4900+(/—14)/12)/100)/4, in which 
/is year, /is month, AT is day. It may be 
necessary to remind modern program¬ 
mers that variables beginning with i, j, 
k were integer variables. Also, the For¬ 
tran compiler processed operators from 
left to right so (j- 14)/12*12 meant 
((/-14)/12)*12. 

• In 1965 or so, my friend wrote a calen¬ 
dar routine for a new operating system 
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Class Libraries 
for Real-Time & 

Charting Graphics 

C/C++ and MFC Development Tools for 
Windows Graphics Applications 

Charting Tools and Real-Time Graphics Tools for Windows 
The Charting Tools for Windows support a wide variety of chart types 
used in scientific and business applications, including line plots, area plots, 
bar graphs, scatter plots, group plots, high-low-close plots and pie charts. 
Prices start at $300. 

The Real-Time Graphics Tools for Windows create dynamic graphical 
displays for use in applications such as network monitoring, scientific and 
medical instrumentation, process control, and financial market displays. 
Graph types include: scrolling graphs, sweep graphs, logic graphs, annun¬ 
ciators, xy plots, dynamic text, dynamic bar graphs, and meters. Also 
supported are customizable LED controls, buttons, scroll bars and check 
boxes. The Real-Time Graphics Tools include all of the Charting Tools 
functionality. Prices start at $600. 

Both products support development of 16-bit and 32-bit applications for 
Windows 3.1, Windows NT, Win32s and Windows 95. They are targeted at 
C/C++ programmers who prefer traditional Windows API style program¬ 
ming. Source code is sold separately. If you want to program using MFC, 
purchase one of these products and the Graphics Class Libraries for MFC 
described below. 

Visual Basic and Delphi versions of the Charting Tools and Real-Time 
Graphics Tools for Windows are also available. Call for details. 

Graphics Class Libraries for MFC 
MFC-based class libraries are available as an add-on product for our 
Charting Tools and Real-Time Graphics Tools for Windows. The Quinn- 
Curtis Graphics Class Libraries for MFC are an extension to MFC, inte¬ 
grating our tools with the Document/View architecture. This library 
includes classes for both the Charting Tools and Real-Time Graphics Tools. 
It provides a convenient object-oriented interface that significantly reduces 
the effort needed to program graphics applications. With these libraries 
you can build graphs that inherit all of the behavior of CWnd, CView, 
CScrollView, and CFormView classes, including print preview. The cost of 
the Quinn-Curtis Graphics Class Libraries for MFC is $200. The full source 
for the class library is included. 

Free Demo Disk and Catalog 

Call, FAX or write for a free catalog and demo disk. Product information 
and demos can also be downloaded from our WWW, FTP and BBS sites. 

Order Now! 

Call: 617/449-6155 Fax: 617/449-6109 



Real-time graphs derived from 
CScrollView and CFormView classes are 
used to create instruments in a MDI 
application. 



Place multiple graphs inside a SDI 
window. 



View your page as it will be printed 
using print preview. 



Combine real-time graphs and dialog 
controls using CFormView. 


30 -Day Money-Back Guarantee ! 

WWW http://www.quinn-curtis.com/~quinn/ 

FTP at ftp.webcom.com in /pub/quinn/demofiles 
BBS 617/449-4783 


Quinn-Curtis, Inc. 

35 Highland Circle 

Needham, Massachusetts 02194 USA 


Windows and Visual Basic arc registered trademarks of Microsoft Corp. All other products are trademarks or registered trademarks of their respocctive owners. 








































































(continued from page 8) ming and I find C to be extremely de- Java Naysayer or Realist? 

which determined the day of the week. manding in terms of syntax and, as a Dear DDJ, 

He was quite proud of it because it was consequence of its compactness, errors First off, let me say that I consider your 

small and fast, important in the center (mine) can be very difficult to locate. I magazine very interesting and professional 

of the operating system. A customer believe strongly that a certain amount (more often than not, I buy a copy even 

complained that it would fail in the year of redundancy in a language is highly if my company subscribes). One thing I 

2000. My friend told me that the com- desirable. It allows the compiler to catch regret, though, is your contribution to all 

ment was irrelevant. He knew the al- a lot of typos, inadvertent omissions, of the Java hype, 

gorithm would fail in the year 2000. He and the like. A good example is re- I am not talking about Java as a de- 

also knew that that operating system quiring an //statement to be terminat- velopment language specifically, but 

would be long gone by 2000. He was ed by an endif. The precise delimiter is rather about its applications to Inter¬ 
right, of course. unimportant. The use of a specific de- net/Intranet solutions (even though some 

• Again, I haven’t read the material Jack limiter is important. A little more re- of the following considerations apply in 

Reeves discusses and Al Stevens defends. dundancy would have made C a lot bet- general to Java). 

I have taken up C since I retired and it ter in the applications world. I was one of the first in Norway to 

is a fine language. It does demonstrate Marvin H. Allison, Jr. download Hotjava (one year ago). I was 

the mind set of the academic. My ex- Acushnet, Massachusetts impressed with the idea of applications 

perience was in applications program- MarvinA3ll@aol.com running on the client side and I expect¬ 

ed to see innovative solutions to be vis¬ 
ible in the next few months. 

What I saw instead are students drink¬ 
ing beer on their homepages, bubbles 
of many colors, small green waves, and 
spinning logos. A ridiculously simple 
spreadsheet was the most serious ap¬ 
plication I came across. I lost count of 
how many times I read the “wait and 
see” sentence in connection with Java. 
Analyzing the architecture of Java in con¬ 
nection with the Web explains many 
things. 

• Java applets can’t write to the local disk 
(and they never will, unless we want to 
get a Java tin - rf* virus the day after¬ 
wards). This means that there’s no way 
to register information between two dif¬ 
ferent Java sessions (unless we rely, as 
usual, on the server side). 

• Java applets take ages to download even 
for the simplest applications. 

• Java is complex enough to require pro¬ 
fessional developers for not so complex 
applications (compare this to the sim¬ 
plicity of HTML, which fueled the Web 
revolution). 

• Ninety-nine percent of the time, people 
need to interface a database or an ap¬ 
plication with the Internet (it would be 
stupid, for example, to download an 18- 
MB database for querying two records). 
In other words, CGI technology is a uni¬ 
versally supported technology which of¬ 
fers interaction (will Java people please 
stop saying that the WWW was not in¬ 
teractive before Java. I find this partic¬ 
ularly irritating!). 

• If you need a complex client/server so¬ 
lution, which CGI cannot offer, then it’s 
much better to code your client and 
server with another tool (using RAD 
tools with TCP/IP for communication, 
for example) without wasting time and 
money trying to make your require¬ 
ments fit into the Java paradigm. 

• The AWT library is different on many 
architectures. This allows support for 


Almost a decade of 
Dr. Dobb s on one 
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Now 

Shipping! 


1 Release 4 | of Dr. Dobb’s/CD includes a 
full 8 1/2 years of Dr. Dobb’s publications 
including all the Journals and all the 
Sourcebooks. The programmers archive, 
not equaled anywhere! 

We’ve included all the editorial 
content from each issue: 
articles, sourcecode, Swaine’s 
Flames, Algorithm Alley, 
Examining Room, 

Programmer’s Workbench, 

Undocumented 

Corner.. .Everything! 

Release 4 includes these 
must-have features: 

♦ Super-fast Full Text, Boolean, 

Search Engine 

♦ Indexes for both Articles 
and Authors 

♦ Complete Printing Access 

♦ Copy/Paste Functionality 

♦ Export Files 

♦ Save Searches for Quick 
Access later 

♦ Annotate and Bookmark for 
Your Future Reference Needs 



Only $79.95! 


When you need the programming 
expertise that Dr. Dobb’s offers, there’s 
no better place to turn. Drop your 
CD-ROM into your drive, search for 
your topic of interest, and view your 
information directly on screen. If it’s 
something you want, print it, copy/paste 
it, or directly export it as a file. 

Over 20,000 Dobbs readers 
can t be wrong. pr.Mi* 
Order your CD-ROIH now! 


Special upgrade price 
for prior owners. 

Owners call — 

800 - 822-1 162 


Order Today! 

800-643-1970 

Email: orders@mfi.com 
Fax: 913-841-2624 
International: use mail, fax, 
e-mail, or call 913-841-1631 
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Oracle Designer/2000 Wins Every 
Gold Medal In Computerworld Poll 






When Computerworld surveyed 1,500 information technology professionals, they named 
Oracle Designer/2000 1M their #1 choice in all modeling and application generation 
categories. Designer/2000 is the only tool that generates and reverse engineers complete 
client/server and web applications, delivering productivity benefits unavailable with 
any other modeling tool. 

For award-winning application development and a copy of 

the Computerworld study, call 1-800-633-0546, ext. 4635, ORACLE* 

or find US on the Web at http://www.oracle.com/ Enabling the Information Age™ 


© 1996 Oracle Corporation. Oracle is a registered trademark and Oracle7, Dcsigncr/2000 and Hnabling the Information Age are trademarks of Oracle Corporation. All rights reserved. 
Award results based on Computerworld I/S Brand Preference. Study published in April 1996. All other company and product names are the trademarks of their respective owners. 




















(continued from page 10) 
maintaining the look and feel of the ac¬ 
tual platforms, in theory, but in prac¬ 
tice, the AWT classes have their own 
different bugs that spoil platform inde¬ 
pendence (once more, no serious Java 
application can run smoothly on all of 
the supported platforms, yet you have 
already given up the platform-specific 
advantages!). 

• Netscape Plug-Ins. Aren’t they much bet¬ 
ter for the development of customized 
Intranet solutions? Maybe they are not 
supported for every platform, but imag¬ 
ine having to download a Java .PDF-like 
reader every time you encounter a .PDF 
document. 

• With Java you can get some control 


on what the user puts in the forms be¬ 
fore shipping to the CGI on the serv¬ 
er, but you can also do this on the 
server side and reissue the form with 
the previously typed text already in¬ 
serted. This solution keeps forms load¬ 
ing with the speed of HTML; no need 
for an applet, and, above all, gives you 
compatibility with all of the browsers 
(even Lynx). 

Yes, Java needs time (usually) to ma¬ 
ture, but while languages in this state 
dwell in universities, Java is being sold as 
state of the art. The whole Java issue 
should be split in two (that this has not 
been said loud and clear, contributed a lot 
to the confusion): 



Make a global impact on 
client/server technology. 


Microsoft gives people access to a whole new world of thinking and communicating. Our 
Architectural Engineers provide Fortune 500 clients with some of the industry’s most innovative 
client/server solutions. They’re backed by unparalleled resources and the chance to leverage 
advanced technologies including the Internet and online services. Immediate opportunities are 
available nationwide. 

SQL Architectural Engineers 

As a technical evangelist, you will provide technical and sales support to ensure high volume and 
successful evaluations, sales and implementations of SQL Server*. You will position Microsoft 
as an enterprise vendor to both business and technical decision makers. Responsibilities will 
include demonstrating SQL Server benefits during database evaluation processes; managing 
the technical partnership with strategically targeted SQL accounts; and providing regional 
training to keep the sales force abreast of the latest technological developments in the Microsoft 
database product line as well as competing and complementary technology. 

Qualified candidates will have a minimum of 5 years systems engineering experience; 
knowledge of enterprise RDBMSs and client/server applications; and advanced technical 
competence in operating systems, applications, languages and hardware. Demonstrated 
success in resolving highly strategic corporate-level business issues, advanced presentation 
abilities and excellent project management skills are imperative. A technical degree is required; 
advanced degree preferred. Positions will involve significant travel. 


Indicate Recruiting Dept DDJ996 and mail, fax or email (in ASCII text format) your resume today. 
No phone calls please. We are an equal opportunity employer and support workforce diversity. 


EAST 

5335 Wisconsin Ave.NW 
Suite 600 
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tonyje@microsoft.com 
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77 W. Wacker Dr. 
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Chicago. IL 60601 
FAX (312) 739-0505 
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Dallas, TX 75248 
FAX (214) 386-0700 
email 
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FAX (206) 635-1049 
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briancor@microsoft.com brianhal@microsoft.com mwhite@microsoft.com 
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http://www.mlcrosoft.com/jobs/ 

Microsoft is a registered trademark and Where Do You Want To Go Today? is a trademark of Microsoft Corporation. 
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• Java as a development language. Sure it 
is interesting, but keep on with your 
work. I guess Java will have a hard time 
replacing C/C++, but it’s worth trying 
from a research viewpoint. 

• Java as a Web client-side language. For¬ 
get it! The idea of transferring an auto¬ 
matically executed application should 
be dropped. The obvious alternative is 
an enrichment of the CGI alternative (I’m 
thinking of a form that lets you select a 
subregion from a picture by sending die 
corners’ coordinates, for example). 

In short, Java, far from being a revolu¬ 
tion, is not even a reform. 

Luca Passani 
Oslo, Norway 
lpa@sysdeco.no 

Founding Father Flub 

Dear DDJ, 

Al Stevens’ May 1996 “C Programming” 
column briefly discusses the Bill Gates’ 
book The Road Ahead, especially the per¬ 
vasiveness of monitoring technology, and 
Gates’ dismissal of this as “unremarkable.” 
I completely agree with Al about this at¬ 
titude: It is frightfully chilling. I also agree 
with the wisdom behind his quotation. 
But my reference book (Bartlett’s Famil¬ 
iar Quotations) gives Ben Franklin as the 
originator of that quote, not Thomas Jef¬ 
ferson (aldiough Jefferson does have some 
other wise things to say about liberty). 
The Franklin quote is given as “They that 
can give up essential liberty to obtain a 
little temporary safety deserve neither lib¬ 
erty nor safety.” 

What with Gates’ attitude and the 
so-called Communications Decency Act, 
we “ordinary citizens” had better keep an 
even closer eye on our leaders, lest they 
lead us along a road ahead that is: 

“A passage broad, 

Smooth, easy, inoffensive, down to 
Hell.” 

—Milton, Paradise Lost 

Greg Guerin 
Tempe, Arizona 
glguerin@amug.org 

P.S. Since I used the “H” word, is this 
e-mail now in violation of the CDA, mak¬ 
ing me a felon? 


DDJ 

DDJ welcomes your comments and sug¬ 
gestions. Send letters to DDJ, 411 Borel 
Ave. f San Mateo, CA 94402-3522. We can 
also he reached via editors@ddj.com, 
76704.50@compuserve.com, a nd by fax 
at 415-358-9749. Please state your name 
and address. DDJ reserves the tight to edit 
letters for length and/or content. 
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Tired 


of low returns on shareware distribution? 


Looking 


for an effective way to show off your products to more potential customers? 


Thinking 


about using the Internet to distribute software? 


Show your stuff with 



The Demo Builder for Windows • 
—the most useful demo tool around! 


Say hello to 

I Dan Bricklin's' 


timeLOCK! 


The Ultimate Trialware Tool 


—Say goodbye to shareware! 



So many uses: 

• On-line demos 

• Electronic brochures 

• Sales presentations 

• Disk-based advertising 

• Tbtorials 

• Interactive demos 

I • Self-running demos 
...and morel 


■ 

The Demo Builder forWndms- 


So popular: 

PC Magazine said, “When you can’t 
be there to demonstrate a program 
yourself, Dan Bricklin’s demo-it! 
makes an effective stand-in.’’ 
Windows Magazine said, “Windows 
evangelists who want to spread the word with a touch of flair can hardly go 
wrong with this powerful presentation tool.’’ And InfoWorld Magazine calls demo-it! "a 
first-rate tool with a variety of uses.” 



One by one, developers are making 
their applications ready for on-line 
distribution. Over 12 million potential 
customers are cruising the Internet 
looking for good software. The)’ demand 
to “try' before they buy.” They don’t want 
crippled-ware, locked files or canned 
demos—and you don’t want to give away 
your software as shareware. So, how' do 
you do it? Say hello to Dim Bricklin's 
timeLOCK!... 


The ultimate trialware tool! 

• Creates fully functional 
“timeLOCKed" versions of 
Windows® software. 


• Opens the door to new distribution channels. 


• Ideal for sales lead fulfillment, direct mail promotions and Internet distribution. 


• Converts to full-time operation (“untimeLOCKing”) only when user pays for license. 


So easy to use: 

Version 2.0 includes all of the easy-to-use demo-it! features introduced in the original 
version of this widely acclaimed demonstration tool, plus these enhancements: 

• Rich Text (RTF Format) • Variables 

• Heartbeat Clock • Simulated Typing 

• Filmstrip Animation • Object Sets 

• Scaling Bitmaps • Revised User Interface 

• Additional Transitions • Finer Timer Control 


Greater control—and easy to use! 

With one function call, Dan Bricklin’s timeLOCK! allows potential customers to evaluate 
your fully functional program for a period of time. Set the trial period and timeLOCK! 
takes care of everything else. 


Product 


Product No. 


Price 


demo-it! V2.0. 

timeLOCK! Developer's Kit with first keycode module/16-bit 
timeLOCK! Developer's Kit with first keycode module/32-bit 
timeLOCK! Additional keycode module for telemarketers. 


LIDSD31-IB .$399 

LIDBT31-IB .$699 

LID3231-IB .$699 

LIDTK31-IB .$499 


Ask us about our “unlocking”service. 

CALL & ORDER TODAY! 

800 * 987*4930 

1163 SHREWSBURY AVE. • SHREWSBURY, NJ 07702 • VOICE: 908/389-0037 • FAX: 908/389-9227 • BBS: 908/389-9783 
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LIFE30AI 


PUBLISHING 


THE POWER TO DEVELOP YOUR IDEAS 

Dan Bricklin's is o registered trademark of Daniel S. Brkkfei. demo-it! is a trodemork 
of lifeboot Publishing. Windows is a registered trodemork of Microsoft Corporation. 
timeLOCK! is o trodemork of Dynosoft Publishing. 
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Paradise No. Discount Price 

AccuSoft Image Gear 6.0 

ACCIG31-FT .$699 

Blinker v4.0 

BIB4031 -FT .$209 

Borland C++ Developer Suite CD-ROM 

BORDS88-FT .$439 

Borland C++ Developer Suite Upg. 

B0RDU88-FT .$315 

Borland C++ v5.0 CD-ROM 

B0RCP88-FT .$339 

Codewright Pro v4.0 CD-ROM 

PCCW488-FT .$199 

Dan Bricklin's demo-itl v2.0 

LIDSD31-FT .$299 

Dan Bricklin's timeLOCK! 16-bit 

LIDBT31-FT .$659 

Delphi Desktop 2 NT/95 CD-ROM 

B0RDF88-FT .$349 

Delphi Developer 2 Version & Comp. Upg 

BORDE88-FT .$269* 

*$50 rebate for version upgrade. 
Graphics Server v4.5 

PPGSR31-FT .$209 

Help Magician Pro Win 95 

SWHM953-FT.$259 

IBM VisualAge C++ v3.5 Win Comp. Upg. 

33H5007-FT $179 

LEADTOOLS V6.0 0CX32 Pro 

LTC0C31-FT .$369 

MS Visual Basic Enterprise v4.0 Upg. 

MSUVE88-FT .$475 

MS Visual Basic Pro Windows v4.0 
Upg. CD-ROM 

MSVUP88-FT .$89 

MS Visual C++ Subsc. v4.0 CD-ROM 

MSVC4S8-FT .$479 

MS Visual C++ v4.0 
Version Upg./Subscription CD-ROM 

MSUVCS8-FT.$339 

MS Visual SourceSafe v4.0 CD-ROM 

MSVSS88-FT .$479 

MS Visual Test v4.0 CD-ROM 

MSVTE88-FT .$579 

Optima++ Developer 

PS0PD88-FT .$189 

PowerBuilder Desktop 5.0 Upgrade 

PWCPG88-FT .$89 

QuickPak Pro Winv4.1 

CRQP031-FT .$199 

Sybase SQL Anywhere v5.0 CD-ROM 

PWSSA88-FT .$249 

Symantec Caf6 vl.O Win 95/NT 

SYMCF88-FT .$125 

VB Tools Win v5.0 

MHVBT88-FT .$99 

Watcom C/C++ v10.6 Competitive Upg. 
WACCV88-FT .$189 


Call for shipping charges/return policy. 
Prices subject to change without notice. 


Back to Visual Basic, 
C/C++ & More... 


Visual SQL® 

by Blue Sky ® Software 
Visual SQL turns Microsoft Visual 
C++ into a full-blown Client/Server 
development environment. Visual 
SQL integrates seamlessly with 
Microsoft Developer Studio using 
intuitive wizards to generate MFC 
Client/Server code. Visual SQL 
automates and shortens every 
stage of the development cycle 
and offers developers the rapid 
application development of a 
Visual 4GL and the power of 
compiled C++ code. 

Paradise No. BLVSQ88-FT 
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NEW!] 


$1719 


dtSearch* 4.1 & 

TextBridge® Pro 96 
OCR Upg.* Bundle 

by DT Software & Xerox 
Turn papers into dtSearchable, 
auto-formatted word processor, 

HTML files & more! Natural 
language, fuzzy, phonic, 
and/or/not, wildcard, proximity, 
field & numeric range text search options. Indexed search time 
usually under a second—even through hundreds of megabytes. 
Displays files as text or images. Unlimited capacity. ZIP support. 
dtSearch is "industrial-strength...superb ."—PC Magazine. 
Developers: ask about dtSearch 32-bit text retrieval engine. 
"Upgrade offer applies to users of any OCR software. 



Paradise No. DTSXB31-FT 


$299 


WISE Installation 

by Great Lakes 
Business Solutions 
Creates professional installations for 
Windows, Windows NT, and Windows 
95 all with a single installation script. 

The WISE Installation System includes 
both 16- and 32-bit versions of the 
integrated development environment. 
WISE includes all of the standard 
installation features plus: custom 
dialog/graphic editors; CD-ROM/Network 
installations; multi-lingual support; and full 
Windows 95 install requirements. 

Paradise No. GLISV31-FT 



c-tree Plus® 

by FairCom 

DOS • WINDOWS • NT • UNIX • 

OS/2 • SUN • RS6000 • HP9000 • 

MAC • QNX • BANYAN • SCO. 

This well known, highly portable data 
management package has become 
established as the tool of choice for 
commercial development. Offering 
unprecedented data control, 
choose from direct low level 
access, ISAM level, or ODBC 
access with the FairCom Server. 

Single User, Multi User, or optional 
Client/Server. ANSI Standard. Full Source. No Royalties. 



Paradise No. FACTP31-FT 


$785 


WEB Office' 

by Blue Sky* Software 
WEB Office is a full-featured, 
integrated suite of easy-to-use 
Web authoring and publishing 
tools that includes everything 
you need to dramatically 
shorten your Web development 
cycle. It’s the easiest way to 
publish and maintain high 
quality Web sites. Includes 
HotSpot Studio, Web Doctor, 

Web Graphics Locator, and 
more! WEB Office is the Complete 
Web Authoring and Publishing Solution. 

Paradise No. BLSW088-FT 



Doc-To-Help 2.0 

by WexTech Systems, Inc. 
Doc-To-Help is the award-winning 
documentation and Windows online 
Help authoring system. Version 2.0 
works with Word for Windows 95 
and offers unequaled support for 
creating and distributing commercial- 
quality printed documentation and 
sophisticated Windows 95, Windows 
NT and Windows 3.1 Help files from 
a single source without compromise 
in medium or platform. 

Paradise No. WTDTH31-FT 



$320 



Dan Bricklin's® 
demo-itr 

The demo builder 
for Windows® 
by Lifeboat 
Publishing 

Need to demonstrate what your 
software can do? With demo-it! 
you can create fully interactive 
or self-running demos, demo-it! 
features rich text support, is 
completely WYSIWYG, launches internal programs, supports 
variables & conditions, has enhanced special effects and works 
great on CD-ROMs, Internet and on-line services. Freely 
distributable 170K runtime player. 

Paradise No. LIDSD31-FT $299 


Spread v2.5 

by FarPoint Technologies 
A complete spreadsheet control 
for most environments that 
support a VBX, OLE control, or 
DLL. Use as a spreadsheet to 
obtain variable lines of data or 
display tables of information. 

Data aware—connect to 
databases with the Access Engine 
and ODBC. Includes over 250 
properties and our improved 

Spread Designer. Formulas, sorting, and full-print support too. 

Paradise No. FASVX31-FT $279 
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Programmer's Paradise 

The developer's best source for software under the sun! 


RoboHELP 5 95 

by Blue Sky z Software 
Award-winning RoboHELP 95 guides 
you through the entire process of 
creating Help systems for Windows 3.x, 

Windows 95, and Windows NT! Full 
support of ALL Windows Help features 
including Windows 95 contents tabs, 
secondary windows, authorable 
buttons, and all the new macros; plus 
RoboHELP 95 gives you the power and 
ease-of-use of Microsoft Word. RoboHELP 95 saves you time— 
it's fast, has instant test mode, and rapidly converts existing 
documentation into a Help system or vice-versa. 

Paradise No. BSRH931-FT $439 



Visual Developers 
Suite Deal 

by Visual Components 
The Visual Developers 
Suite Deal is better 
than ever. Now with 
five full OCX tools 
for developing 
great apps. Includes 
the latest versions of 
Formula One for dynamic 
spreadsheets, First Impression 
for stunning charts, VisualWriter for robust text editing, 
VisualSpeller for powerful spell checking, and WebViewer for 
convenient HTML browsing. It's our best deal yet. 

Paradise No. VTVSD31-FT $289 



Codewright 4.0 

by Premia 
More powerful than ever 
with the new API Assistant! 
Prevents bugs before they 
happen; has Button Links to 
non-text files; and Direct 
Access version control inter¬ 
face. Multi-file search and 
replace, help topic scanner, file differencing and merging, are real 
time-savers. 
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VT-Protect 

by Viatech Inc 
Put an end to software 
piracy...at least for your 
products! VT-Protect is 
fundamental to protect your 
software product revenues, 
reduce product costs, minimize product 
licensing headaches and improve user 
satisfaction. VT-Protect’s proven secu¬ 
rity mechanism gives you the power to 
control licensed use of your software for demos, evaluation and 
proper production use. No more freebies or trialware! Available 
for PC or UNIX. 
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WinHelp Office' 95 

by Blue Sky s Software 
WinHelp Office 95 includes 
everything you need to quickly 
and easily create professional, 
full-featured Help systems for 
Windows 95, Windows NT, 
and Windows 3.x—all in one 
box! WinHelp Office 95 is 
power-packed with the award¬ 
winning RoboHELP (16- and 
32-bit versions), WinHelp 
Video Kit, WinHelp Tool Kit, WinHelp HyperViewer, Mastering 
WinHelp, and the Moving to WinHelp '95 Kit. 

Paradise No. BKWH031-FT $649 



Helpsite 

by Wextech Systems, Inc. 

Congratulations! Simply by pushing 
your index finger down an eighth of 
an inch, you've just converted your 
Help project into World Wide Web 
documents. This near effortless feat 
is made possible by Helpsite, the 
HTML conversion tool from WexTech 
Systems. One click lets you recreate 
a Windows help project as a full- 
featured Web site. And Doc-To-Help 
users can use Helpsite to create and maintain printed 
documents, Windows Help and HTML from a single source. 
Helpsite, just one click and you'll be converted. 
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KEDIT for Windows 1.5 

by Mansfield Software Group 

Includes both 32-bit Windows 95/ 

Windows NT and 16-bit 
Windows 3.1 modules. KEDIT 
is a powerful general purpose 
text editor with redefineable 
keys, undo/redo, selective line 
editing, regular expression 
support, enhanced syntax 
coloring, column oriented 
editing, file locking, a macro debugger, an IBM XEDIT- 
compatible command set, prefix area support, and more! The 
macro language is a subset of REXX. Also available in DOS and 
OS/2 text mode versions. 

Paradise No. MANKE31-FT $139 
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iilp2web 

by 0 2 GAMultimedia 
hlp2web converts help systems 
to full-featured HTML Web sites. 

Includes: Help hypertext state¬ 
ments to their equivalents; 

SHG, BMP and WMF files/links 
to GIF/JPEG and (client side) 
image map files; Windows 95 CNT file to a home page; 
Multimedia statements to HTML tags; Keeps all font attributes; 
Generates HTML 3.0 tables; Headers, footers and a lot more 
customizing features. hlp2web is a standalone product that is 
easy to integrate in any Help authoring tool. 

Paradise No. OGAMH31-FT $249 


To Order Call 800-445-7899 



Neiv online catalog! 
See our website at 
http://www.pparadise.com ' 


It's that time of year, 
again! 

While the kids head back to 
school, you can get back to work— 
with the help of Programmer's 
Paradise. Find Visual Basic 
products, C/C++ tools, Client/Server 
solutions and other programming 
necessities—plus fast, friendly 
service, super savings and special 
offers. Programmer's Paradise is 
your source for the best products 
and service available today! 

Sure-To-Please 
Service...A Personal 
Guarantee! 

"If you're not happy, we're not 
happy! You have my personal 
guarantee that we'll provide 
you with outstanding products, 
support and service." 

—Roger Paradis 

President & CEO 
Programmer's Paradise, Inc. 

ORDER NOW 

For a complete buffet 
of products and 
savings, call for your 
free catalog! 
1-800-445-7899 
FAX 908-589-9227 
www.pparadise.com 
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Goal-Directed 
Software Design 


From the Ul to the underlying 
architecture, user satisfaction 
is what’s important 

Alan Cooper 

B y assuring that your software moves users inexorably to¬ 
ward their goals, you can design programs that are deeply 
satisfying and effective. In this article, I’ll present a method¬ 
ology called “Goal-Directed Design” that makes this possi¬ 
ble, allowing you to eliminate unnecessary features from your 
software, separate good design ideas from bad ones, and cre¬ 
ate software that makes users happier and more productive. 

To illustrate how this method works, suppose you are de¬ 
signing a group-calendaring program in which users coordinate 
meetings (and other activities) by drawing on a calendar. The 
number-one task performed by almost all group-calendaring 
software is to create meetings. However, the number one goal 
of almost all users of group-calendaring software is to avoid 
meetings—at least to avoid needless, unproductive meetings. 
This contradiction—where the user’s goals and the program’s 
tasks are in direct opposition—is symptomatic of the failure of 
our current design methods to work effectively. What’s more, 
this contradiction is found almost universally in our software, 
regardless of its type. 

Goals versus Tasks 

It is easy to confuse goals with tasks, but the two are very dif¬ 
ferent and are often in direct opposition to each other. For 


Alan developed the method of designing software described in 
this article, naming it “Goal-Directed Design™" Cooper Software, 
his design consulting company, uses it exclusively. Alan is best 
known as the Father of Visual Basic and author of About Face: 
The Essentials of User Interface Design (IDG Books, 1995). You 
can contact him at alan@cooper.com or http://www.cooper.com. 


example, doctors—whose goal it is to keep you healthy—spend 
all of their time and energy curing your illnesses. 

The confusion is rampant in computer systems, too. The 
programmer’s task is to ensure that the program doesn’t get 
confused, so you put barriers up to assure that no unexpect¬ 
ed data gets entered into the database. However, the user’s 
goal is to quickly handle the varied and unpredictable de¬ 
mands of the client. If the client, for example, hasn’t yet es¬ 
tablished where an order should be shipped, and the program 
rejects the order because it lacks a valid shipping address, the 
software has achieved the task of data integrity while utterly 
failing to achieve the goal of recording the client’s order. An¬ 
other way of looking at this is that the author of the software 
has mistakenly imposed his goals on the user, instead of mak¬ 
ing the code work to achieve the user’s goals. It is certainly 
beneficial to maintain an unsullied database, but not at the 
expense of employees who interact with the database or a 
client who is rebuffed. 

Another example of goal/task confusion is the design of 
bookkeeping systems. Manual bookkeeping systems were prone 
to human error. The double-entry method was invented to fix 
this problem. Essentially, each transaction was booked twice in 
two separate accounts. When the totals didn’t balance, it was 
an indicator (that is, an error message) telling accountants to 
check their math. Ever since, bookkeeping systems have been 
built around this double-entry idea. 

Enter the computer, a tool with many shortcomings, of which 
arithmetic capability is clearly not one. Although computers don’t 
make addition and subtraction errors, most computerized book¬ 
keeping systems religiously use the double- entry system. 

When you examine bookkeeping from the point of view of 
the user’s goals, rather than merely examining the familiar, man¬ 
ual tasks, you find that making two entries isn’t a goal. If the 
people in business could get reliable accounting with one en¬ 
try, they’d do it. If they could do it with no entries , they would! 
The point isn’t the method, it is the objective. 

Avoiding Meetings 

Returning to the group-calendaring example, how can a pro¬ 
gram that is supposed to make you attend meetings allow you 
to avoid them? Let’s take the agenda facility in our calendar and 
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turn it to our advantage. This feature lets you write a short note 
describing the meeting’s purpose, attach it to the schedule, and 
send it to all of the invitees. It might say “Please meet with me 
on Tuesday, June 17th at 3:00 to decide on the retail price of 
our new Spam-0-2000.” Normally, everyone will trudge to the 
meeting and yawn through long-winded pleas for various prices. 
Instead, you might allow users to create an agenda ivithout at¬ 
taching it to a meeting. The agenda note now says “What should 
we charge for the Spam-0-2000?” and is sent to the same list of 
people. If the responses range from “ten dollars” to “ten thou¬ 
sand dollars,” you have a problem and must call a meeting. On 
the other hand, if everyone replies “a buck-fifty,” “whatever you 
want,” or some other useful consensus, then you have succeeded 
in avoiding a meeting! The software has directly helped you 
achieve your goal. 

What is remarkable about this solution is that most existing 
group-calendaring systems have agenda features already built 
into them. It wouldn’t take much programming effort to dis¬ 
connect agendas from meetings. Designing for the user’s goals 
is easier than you think. Mostly, it’s a matter of trusting in goals 
and ignoring the hegemony of tasks. 

The Goal Stack 

The range of possible goals is not homogeneous. As Table 1 il¬ 
lustrates, I divide goals into four basic categories: false, corpo¬ 
rate, practical, and personal. 

In the software industry, we are intimately familiar with the items 
in the false-goals category. Most of the software we use is written 
with them in mind. These goals can easily be achieved by ignor¬ 
ing users and focusing on the needs of the code. This explains 
their prevalence in existing software: Because programmers must 
be concerned with software, they often foiget about users. 


These goals are false because they apply only to the task 
of software creation, while ignoring the software’s use. The 
remaining goals are false because they are tasks, features, and 
tools. They are means to ends, but not ends in themselves, 
and goals are always ends. A target like “safeguarding data in¬ 
tegrity” isn’t a goal for a personal mailing-list program the 
same way it might be for a program that calculates shuttle or¬ 
bits. A target like “saving memory” is unimportant for the typ¬ 
ical database query where downloads are small and comput¬ 
ers are big. Even a target like “being easy to learn” isn’t a 
primary goal for the software in a jet-fighter cockpit, where 
the software’s only users will be specially trained pilots. I’m 
not giving license to make software that’s hard to learn, I’m 
just pointing out that a fighter pilot who found weapons sys¬ 
tems easy to learn— but slow and cumbersome to operate— 
would be at a distinct disadvantage in an aerial dogfight. The 
pilot’s goal is to emerge from combat victorious, not to sim¬ 
plify flight instruction. 

Complicating the false-goals issue are two powerful forces— 
history and innovation. 

Technical innovation is the engine that drives our industry. 
Since the invention of the microprocessor, the computer rev¬ 
olution has surfed a wave of new technology. Any company 
that ignores new technical ideas is doomed. But don’t con¬ 
fuse these techniques with goals. It may be a software com¬ 
pany’s task to use new technology, but it is never a user’s goal 
to do so. As a user, I don’t care if I get my job done with hi¬ 
erarchical, relational, or object-oriented databases (or black 
magic, for that matter). All I care about is getting my job done 
with a modicum of ease and dignity. Technology is like salt: 
You can’t make a meal without it, but it doesn’t nourish all 
by itself. 





Last year, for example, Visioneer carved out a big share of 
the desktop-scanner market from well-entrenched competitors. 
This was remarkable because Visioneer’s PaperPort scanner sys¬ 
tem was only old-fashioned black-and-white, while the com¬ 
petition could scan either gray-scale or full color. But Visioneer’s 
system included goal-directed software that allowed users to 
easily view and manage scanned images, while other software 
merely dumped the scans into the file system. 

The software-development world labors under many as¬ 
sumptions that are historically true, but have been made ut¬ 
terly false by the march of time. In the ’60s and 70s, when 
you (or the person who taught you) learned about comput¬ 
ers, the dominant paradigm was the exorbitant cost and sub¬ 
sequent shortage of processor cycles, main memory, and sec¬ 
ondary disk storage. Consequently, most of the really cool 
techniques in computer science are based on the need to con¬ 
serve cycles and bytes, even though modern computers have 
plenty of memory, plenty of storage, and an embarrassment 
of compute-cycle riches. The other historical ball and chain 
is the annoyingly persistent falsehood that to use a comput¬ 
er you must become “computer literate.” This is just an ex¬ 
cuse we in the industry use to salve the guilt caused by our 


False 

Save memory. 

Save keystrokes. 

Be easy to learn. 

Safeguard data integrity. 

Speed up data entry. 

Increase program execution efficiency. 

Use cool technology or features. 

Increase graphic beauty. 

Maintain consistency across platforms. 

Corporate 

Increase our profit. 

Increase our market share. 

Defeat our competition. 

Hire more people. 

Offer more products or services. 

Go public. 

Practical 

Avoid meetings. 

Handle client’s demands. 

Record client’s order. 

Create a paper model of the business. 

Personal 

Not feel stupid. 

Not make mistakes. 

Get an adequate amount of work done. 

Have fun (or at least not be too bored). 


Table 1: Software goals divided into four basic categories. 



Figure 1: Weekly view in Microsoft's Schedule + Version 7.0. 


inability to create adequate design. Instead of making soft¬ 
ware easy to use, we blame users. 

Corporate Goals 

Corporations have their own requirements for software, and 
they are as high level as the goals of the individual. “To in¬ 
crease our profit” is pretty fundamental from the viewpoint of 
the board of directors or the stockholders. Designers can use 
these goals to help keep their focus on the bigger issues and 
avoid getting distracted by tasks or other false goals. 

Psychologists who saidy the workplace have a term, “hygienic 
factors,” which Saul Gellerman C Motivation and Productivity , 
New York, N.Y.: Amacom, 1963) defines as “prerequisites for ef¬ 
fective motivation but powerless to motivate by themselves.” 
The lights in your office, for example, are hygienic. You don’t 
go to work because the lights are nice, but if there were no 
lights at all, you wouldn’t bother showing up. 

I have adapted this term as “hygienic goals,” which I define 
as goals that are prerequisites for effective functioning, but 
powerless to achieve success by themselves. All of the cor¬ 
porate and practical goals in Table 1 are hygienic. From the 
corporation’s point of view they are important goals, but the 
corporation isn’t doing the work, people are, and their goals 
are different. 


Practical Goals 

Practical goals are the bridge between the objectives of the 
company and those of individual users. In the calendar exam¬ 
ple, the practical goal of avoiding unnecessary meetings con¬ 
nects the corporate goal of having good business communica¬ 
tions with the user’s personal goal of being productive. 

Programmers are often practical people, and these goals have 
much appeal. The touchy-feely nature of personal goals are less 
appealing to their engineering sensitivities. True to their naaire, 
they create software that— although it admirably fulfills the prac¬ 
tical goals—fails utterly to satisfy the individual user. An inter¬ 
face that is complex and obscure can provoke users to make mis¬ 
takes and obstaict their ability to be personally productive. This 
makes them feel bad about themselves and the software. 

On the other hand, if your software ignores practical goals and 
serves only user’s goals, you have just written a computer game. 


Personal Goals 

Personal goals are always true and operate, to varying extents, 
for everyone. If users are made to feel stupid by the software, 
their self-esteem droops, and their effectiveness is reduced. 

Learning how to manage the file system is difficult for most 
users, and they see it merely as an obstruction to getting an ad- 
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Figure 2: The daily view in Schedule +. 
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(continued from page 18) 

equate amount of work done. Virtually all software with a “File” 
menu violates the user’s personal goals. 

When a program continually badgers users with confirma¬ 
tion dialog boxes, users begin to feel like the program isn’t 
all that eager to help out. Imagine if you had an assistant who 
continually asked, “Are you sure you wanted me to file this 
report?” or “Are you sure you wanted to throw away this old 
paper?” 

Probably the worst violator of personal goals are error mes¬ 
sages. These obnoxious little idioms serve no purpose that couldn’t 
better be served another way. They blame users for the software’s 
shortcomings. 

There is a close parallel between corporate and personal goals: 
Both are the highest expressions of goals for their respective own¬ 
ers. Neither can be slighted. Software that fails to achieve either 
one will fail. 

Excise and Navigation 

Programmers think about software in terms of the individual 
tasks that users must perform, and their software reflects that 
orientation. Most software is a collection of features, one per 
task. Each separate feature has a corresponding user-interface 
element. Each bit of interface adds overhead, what I call “ex¬ 
cise,” or extra work that users must perform merely to man¬ 
age the idiom, with no benefit to the user or the business. 
This includes things like moving windows around or pressing 
OK buttons. Lots of interface elements means lots of added 
excise. After a while, users spend as much time flipping be¬ 
tween views, scrolling down lists, and summoning dialogs as 
doing their work. 

In addition, because most business tasks are reasonably com¬ 
plex and have many variants, the feature count climbs rapid¬ 
ly. With it, the interface-element count also climbs, and the 
difficulty of navigation is added to the burden of excise. Be¬ 
cause there are so many features, users need to know how to 
navigate from one to another at the proper time. 

The man burdens of excise and navigation conspire to make 
many users feel trapped in an unproductive maze. This feeling 
is directly contradictory to their personal goals. 

A Goal-Directed Exercise 

Because the demands of my work week are often so different 
from the demands of my weekends, I frequently lose track of 
the relationship between Sunday night and Monday morning. 
To achieve my goals, then, any schedule program must help 



Figure 3: The efficient display of information in this 
proposed calendar interface reduces navigation trauma. 


me to check and see how the transition between Sunday night 
and Monday morning will work. 

Figure 1 shows my meeting schedule for the week of May 
26th. I can see all that I have to do. By pressing the small ar¬ 
row buttons in the upper-left and right corners, I can switch 
to the previous or following week. However, if I want to check 
on what I’m doing Sunday the 25th, I have to change modes 
first. Merely asking for the previous week only gets me the 
weekdays of the 19th through the 23rd. The weekly view 
doesn’t show weekends. So I have to go to the tabs running 
down the left side of the calendar and switch to the “Daily” 
view. Only then can I press the “previous” button to see Sun¬ 
day the 25th, as in Figure 2. Of course, then I can see only 
Sunday, and can’t see the juxtaposition between the last day 
of the weekend and the first day of the work week. Lots of 
excise, a navigational maze, my practical goals are thwarted, 
and I begin to feel stupid. 

The question that leaps to mind is: Why must we think of our 
calendar as either a weekly view or daily view? Some paper cal¬ 
endars show a week at a time, some one day per page, and the 
common wall calendar one month per page. These idioms ex¬ 
ist not because they are superior presentations of days , but be¬ 
cause they are the best compromises with the limitations of pa¬ 
per. A paper calendar that showed me only three or nine or 
twenty-one days at a time would be a silly refutation of the tech¬ 
nology. However, in the software world, we are not limited to 
the permanent printed nature of paper. We can dynamically dis¬ 
play anything on the screen, and we can morph and change it 
as we desire. There is no reason my software calendar can’t 
show me a total of twenty-one days, but with seven of them 
emphasized, and the one currently being focused on fully ex¬ 
panded, as in Figure 3. 

Actually, the three views (or modes) of Microsoft’s 7.0 Sched¬ 
ule*—monthly, weekly and daily— are really not appropriate for 
most users. Usually, I want to look at today with a sharp, detailed 
focus, but I want to see the rest of this week in lesser detail at the 
same time. It would be good, too, to see all of the next two weeks, 
even if the detail is minimal. Suppose I had a business trip com¬ 
ing up, where I would travel to Europe this Thursday, returning 
a week from next Tuesday. I need to see how this trip fits into 



Figure 4: The monthly view in Schedule+ is a paragon of 
pixels sacrificed on the altar of meaningless regularity. 
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my schedule at die home office, but I also need to see how indi¬ 
vidual appointments dovetail into the 12 days I will be on die road. 
My trip begins in May but ends in June, so unfortunately I cannot 
see the whole trip with any of Schedule+’s views. The mondily 
screen (Figure 4) wastes pixels by the thousand by showing use¬ 
less days. I have to continually flip from a one-screen view of May 
to a different one-screen view of June. Look again at Figure 3 and 
you see diat the display doesn’t treat the division between May 
31st and June 1st as anydiing special, so the entire trip is visible 
at one time on die screen. It meets my goals, rather dian die false 
goals of “one mondi per screen.” 

Dragging the historically familiar paper-based forms of pre¬ 
sentation into the digital world merely keeps me from doing 
what I want—to see a more flexible, fish-eye view of my 
schedule, where “today” is shown large and in sharp detail, 
and future days are shown progressively smaller and in lesser 
detail. As I arrow back and forth between the days, the one 
day currendy under my scrutiny would be shown in rich de¬ 
tail with full supporting text, while days farther away would 
be shown with decreasing amounts of detail, consuming few¬ 
er precious pixels. 

This style of calendar dramatically reduces the amount of ex¬ 
cise and navigation trauma forced on users. There is only one 
mode (view), so users never have to flip loe tween “Daily,” “Week¬ 
ly,” or “Monthly” settings. Concomitant with this, users don’t 
have to see a shift in the visual context, which can be confus¬ 
ing. Users who still wish to see this week, then the next week, 
without paying attention to the weekends, can shift a week at 
a time with a single mouse click. And by simply never point¬ 
ing to a weekend day, users maintain emphasis on just the work 
week. For the rest of us, however, scrolling or double clicking 


on the smaller weekend day brings Sunday night into view, au¬ 
tomatically showing its relationship to Monday morning. 

Figure 3 isn’t meant to be a complete design, but it hints at 
other advantages, too. Comparing it to Figure 1, you can see 
that the exacting time ruler that runs down the left of the screen 
is missing. Prominently displaying the starting time of daily events 
is critical. The ending time of most business meetings is never 
as important as the start time, yet Microsoft’s Schedule* demands 
that you treat durations and end times with the same emphasis 
on precision, completeness, and graphical perfection as start 
times. From the goal-directed perspective, several tasks imposed 
on users can be easily dispensed with. The end of one meeting 
is easily defined by the beginning of the next one. 

Your Mission, Should You Choose to Accept It... 

You can create dramatically different and more-powerful soft¬ 
ware by letting the user’s goals be your guide. Comparing fea¬ 
tures to the goal yardstick gives you the ability to make clear 
decisions about their efficacy. Sometimes you will even find that 
eliminating costly features improves programs, as I showed in 
the Schedule* example. You don’t have to feel guilty about 
shrinking the feature list if you know that you are reducing ex¬ 
cise and navigation. 

If you ask users how to design their software, they will ignore 
their own goals and describe tasks to you with the same alacrity 
as programmers. The process of designing for users’ goals is one 
that begins with you, the software designer, and not with the 
user. You must identify the hygienic goals and the users’ per¬ 
sonal goals and design an interface that serves them directly, ig¬ 
noring all other demands. 

DDJ 



With LotusScript 
SmartSuite, you 
custom 

to the Internet, 


And chances arc you already 
know how to use it. That’s 
because LotusScript™ is BASIC - 
the industry standard you’ve 
been using for years. 
SmartSuite’s® millions of lines 
of code - which we’ve already 
designed, built, and tested - 
give you your building blocks 
for custom applications. Don’t 
your users spend most of their 
day in spreadsheets and word pro¬ 
cessors anyway? Wouldn’t a little 
automation and integration make 
them a lot more productive? Use 


In Canada, call 
1-800-GO-LOTUS. ©1996 
Lotus Development Corp., 

55 Cambridge Parkway, Cambridge, MA 02 H2. All 
rights reserved. Lotus and SmartSuite arc registered trademarks 
and LotusScript and Notes arc trademarks of Lotus Development Corp. 
All other products arc registered with their respective companies. 


LotusScript to drive your appli¬ 
cations from within SmartSuite, 
or your favorite OLE 2 
controller (like Visual 
Basic) if you’d rather 
work from the outside. 

What’s more, Lotus 
SmartSuite’s tight integra¬ 
tion with Lotus Notes™ 
and the Internet gives 
your custom applications 
everything they need to 
communicate with the work¬ 
group or the world! 

So before you know 
it, you’ll be on your way 
home, thinking of all 
the great scripts you 
can create for your busi¬ 
ness and your customer. 
To get on board, visit 
SmartSuite on mvw.lotus.com, or 
call 1-800-TRADE-UP, cxt.B934 to 
get more information on develop¬ 
ment and on business 
opportunities with 
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Versions 

Available 


JPEG 
TIFF 
Group III 
Group IV 
PCX 
TGA 

, PGM 
DIB * 
IMT 
DCX 
BMP 
KFX 
RLE 
LV 

CALS 

ATT 

CLP 

XWD 

XBM 

CIF 

IFF 

SUN 

PNM 

IOCA 

GX2 

XPM 

ASCII 

CUT 

GEM 

BRK 

MAC 

PSD 

MSP 

PNG 

PCD 

IMG 

IGF 

SGI 

ICO 

PBM 

PPM 

MO:DCA 

WMF’ 

WPG’ 

PICT’ 

EPS’ 

GIF* 

ABIC 1 

JBIG 1 

DICOM 1 

and others 

zt\ 


Windows 
Win95\NT 
MIPS NT 
Alpha NT 
VBX 
OCX 
OS/2 
SUN OS 
Solaris 
HP-UX 
R S/6000 
SGI 
SCO 
MAC 

PowerMac 


Over 45 File 
Formats 


Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

Cl 996 AccuSoft Corporation. All Rights Rcicncd All company and brand names are trademiuli or registered tradenutis of then respective owners. I, Raster only 2. License required from Unisys for formats using LZW compression 3. Optional. 


AccuSoft announces a totally new product, 
ImageGear* , the next generation in imaging 
technology. ImageGear, the new version of the 
AccuSoft Image Format Library - , is more than just an 
upgrade, it is a whole new level of the 
quality and performance that has 
made AccuSoft the leading supplier of 
imaging toolkits. Just for starters, we 
redesigned all the image filters to add 
several new features to ensure that 
our support for image formats is by far the most 
comprehensive. We even added file-info 
executables for every format we support - and, of 
course, we added several new formats. 

ImageGear has a new and improved API that makes 
integration even easier, plus many new features 
including totally redesigned display functions for 


faster image display, sub-pixel accuracy, 
transparency, and an automatic image window with 
many built-in features. We also added new GUI 
functions including a comprehensive thumbnail 
browser, pan and zoom windows, 
magnifying glass, page sorter and 
more. All with complete 
programmability. We completely 
revamped the image processing to 
add dozens of new functions and 
better performance. In addition, we have improved 
the scanning, image compression, display effects, 
and just about everything else! 

So get into high gear with ImageGear and remember 

- the best imaging toolkit makes the best applications 

- ImageGear 6.0! 


A** i 
tiers' 00 ' 


6.0 


The Best Imaging Toolkit - Is 


HIGH PERFORMANCE 
CONVERSION 
SCALE-TO-GRAY 
IMAGE PROCESSING 
THUMBNAILS 
PRINTING 
SCANNING 
FAST DISPLAY 
COMPRESSION 
and more! 


Now Even Better! 


You can start using 
I AccuSoft products 
today by taking 

aaikii i-rer advantage of our 
rMNUl c. unique 30 Minute 

Velivery Dellver yProgram. 


Toll Free: (800) 525-3577 
Website: accusoft.com 


AccuSoft 

High Performance Imaging 
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Customizing the 
Explorer Open Dialog 


The secret is in 
OFN_EXPLORER 


Al Williams 

O ne of the most radical changes Win¬ 
dows 95 makes to the traditional 
Windows user interface is the com¬ 
mon file-open dialog. Instead of the 
old standard, Windows 95 uses a special 
open dialog that looks like a miniature ver¬ 
sion of the Explorer (see Figure 1). From 
this dialog, users can rename files, create 
directories, and (of course) open files. 

Customizing the common dialogs has 
always been a hassle. Now that the open 
dialog looks different, the steps you take 
to customize it are very different, too. In 
this article I’ll explain how to customize 
the new dialog, and show an example 
component for Borland’s Delphi 2.0. Even 
if you don’t use Delphi, you can still ap¬ 
ply these ideas to any other 32-bit lan¬ 
guage. 

Making the Dialog Appear 

If you don’t take any special steps in a 
Windows 95 program, you’ll get the same 
old open box that Windows 3.1 and Win¬ 
dows NT use. The secret to making the 
new dialog box appear is to specify 
OFN_EXPLORER as a flag in the OPEN- 
FILENAME structure. If you are using Del¬ 
phi, this occurs automatically (unless you 
have NewStyleControls set to False). If you 
want the new-style dialog, you don’t need 
to do anything—unless, of course, you 
want to customize the dialog box. 


Al, a consultant specializing in software 
development, training, and documenta¬ 
tion, is the author of Steal This Code! (Ad¬ 
dison-Wesley, 1995). You can find Al on 
the Web at http.V/ourworld.CompuServe 
. com/homepages/A l_Williams. 


Many applications need a customized 
dialog box. You might want to display in¬ 
formation about the selected file, or a pre¬ 
view of the file. I like to show the entire 
path in the open dialog. It is peculiar that 
the new open dialog doesn’t show the en¬ 
tire path to the file in an easy-to-read for¬ 
mat. The sample program I present with 
this article (available electronically; see 
“Availability,” page 3) opens BMP, WMF, 
or ICO files. While opening the file, you’ll 
see the entire path you are browsing. 
You’ll also be able to click a preview but¬ 
ton to see a thumbnail of the graphic. 



Using a Hook Function 

The first step in customizing the open di¬ 
alog is learning about important events 
that occur within the dialog. You can in¬ 
stall a hook function that acts like an or¬ 
dinary window procedure by setting the 
OFN_ENABLEHOOK flag and placing the 
address of the hook in the IpfnHook field 
of the OPENFILENAME structure. The 
hook function looks like an ordinary win¬ 
dow procedure. It receives a window han¬ 
dle argument, a message, and the ubiqui¬ 
tous wParam and IParam parameters. 

In a hook function, you’ll most often 
want to process WM_NOTIFY messages. 
This message (which is new to Windows 
95) is how many controls notify your pro¬ 


gram of events. In contrast, if a standard 
edit control runs out of memory, it sends 
your program a WM_COMMAND mes¬ 
sage. That doesn’t make sense. Common 
controls and the newer common dialogs 
that need to send information that isn’t re¬ 
ally a command use WM_NOTIFY. 

All WM_NOTIFY messages come with 
a pointer to a structure in IParam. How¬ 
ever, this presents a classic chicken-and- 
egg dilemma. The type of die structure de¬ 
pends on the type of the notification. 
However, the control embeds the type of 
the notification in the structure. Confus¬ 
ing, isn’t it? The trick is diat all notification 
headers start with the same few bytes (a 
NMHDR structure; see Table 1). You can 
treat a pointer to any notification structure 
as a pointer to a NMHDR. Then you can 
retrieve the code that identifies the type of 
die structure and recast die pointer. Object- 
oriented programmers will recognize this 
as a crude form of polymorphism. 

Table 2 lists the notification codes you 
may receive from the open dialog. You 
won’t often need to cast the notification 
structure since the only information sent, 
in most cases, is diat the event occurred. 
The complete OFNOTIFY structure ap¬ 
pears in Table 3. 

Windows uses confusing names for some 
of the notification codes. For example, you 
might reasonably diink diat CDN_FOLDER- 
CHANGE occurs when the user changes 
die current folder. It does do diat, but you’ll 
also receive die same notification as die di¬ 
alog opens to inforni you of the initial fold¬ 
er. This is a good thing, of course, but the 
name is a bit misleading. 

Another notification that may not be 
obvious is CDNJNITDONE. This notice 
indicates that the dialog has finished set¬ 
ting up its controls. This is a good time 
for you to initialize your custom controls 
since you can count on the contents of 
the original dialog controls. 

Customizing the Resource 

To add your own controls to the open di¬ 
alog, you’ll need to construct a dialog 
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Had fun building 
anything lately? 
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Introducing Optima++: The RAD new way to build applications in C++. 


Optima* + Developer offers: 

• Component-centric RAD environment 

• Industry-standard, object-oriented C++ 

• Drag-and-drop programming 

• Over 150 components and classes 

• Exceptionally tight, fast code 
• 32-bit Windows applications 

• Robust, just-in-time debugging 

• Powerfdproject management 

• Visual SQL Query Editor 

• Fast, direct connection to ODBC 

• Scalable Sybase SQL Anywhere database 


Now there’s a visual, compo¬ 
nent-based and (dare we even say it?) 
fun way to develop in C++. 

New Optima++ Developer from 
Powersoft* 

For the first time, you can 
quickly build custom client/server 
applications using drag-and-drop 
programming, pre-built components 
and the power of C++. So you can 
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deliver extraordinary' solutions — 
at an extraordinary speed. 

Want lightning-fast applica¬ 
tions? Optima++ helps you build 
them using the same industry-lead¬ 
ing compiler technology as 
Watcom™ C/C++. But fast code is 
only half the story with client/server— 
you also get fast, direct ODBC 
access and the powerful Sybase*SQL 


i Powersoft 


Anywhere™ database to help you 
deliver peak performance. Plus, you 
have the choice of deploying applica¬ 
tions as standalone EXEs or compact 
EXEs with run-time DLLs. 

Start developing with new 
Optima++ today. You’ll get power. 
You’ll get productivity. And you’ll 
even get a chance to rediscover the 
fun in programming. 

m 



Get Optima** Developer for $199* for a limited time: 1-800-395-3525 or www.powersoft.com 

'limited lime only. Regular S.R.P. is S499. © 1 *>% S)1xtse. Inc. All rights reserved. Powersoft and Sybase are registered trademarks, and Optima,,. Watcom CJC** and SQL Anywhere are trademarks 
of Sybase, Inc. or its subsidiaries. All other trademarks arc property of their respective owners. Outside the U.S., call 508-287-1500. Check out Gmcn Bros. Aviation’s ultra-cool Hawk Gyroplane at www.grocnbros.ci 




















1 Better Productivity Tools! 


TE Developer's Kit 

Rich Text Edit Control 


This advanced Rich Text 
control features Wysiwyg multiple fonts 
and colors; paragraph indentation, justifica¬ 
tion, spacing, tabs, border and shading; RTF 
import/export, embed pictures, controls, and 
OLE objects, read-only mode and printing. 
Advanced features: Pagination, columns, 
sections, hyperlink support, hidden and 
protected text, tables, page header/footer, 
text/picture frames, line/boxes, print preview 
with zoom. Includes DLL, VBX, OCX, and 
MFC interface. Also includes the complete 'C' 
source code. (Windows or WIN32 : $389). 

Call for DOS & 0S2 versions and an HTML 
viewer control add-on ($299) 


ReportEase Plus 


ReportEase Plus consists of a report 
layout editor and a report executer. Advanced 
features include: multiple files, multiple sorts; 
data, calculation, system, and dialog fields; 
bold, underline, italic formats; subtotals, 
record filter, functions, word wrapping and 
more. This DLL/VBX features a graphic form 
editor with line/box drawing, colors/ 
shades, dragfdrop, print preview, etc. 
Includes the 'C' source code. (Windows: 

$459, WIN32: $459) 

Also available a DOS version. ($389\ 


Rich Text Grid Control 


This table control features cells 
containing text with multiple fonts, styles, 
and paragraph attributes. Other features 
include row and column spanning, embedded 
pictures, OLE. Includes the V source code. 
(Windows or WIN32: $399). 


Spell Time 


Spell Time consists of a dictionary 
(over 100K words) and the routines to access 
the dictionary. It also includes an application 
specific dictionary, and a user dictionary. The 
routine will suggest alternatives for a 
misspelled word. Highly optimized: 400 to 
500 words/sec on a 33 Mhz 386 computer. 
Includes the 'C # source code. Specify DOS, 
Windows, WIN32 or 0S2-PM. ($389) 


ChartPro 


This DLL draws bar, pie, line, area, 
xyz point chart and hilo presentation graphs 
in unlimited styles in 3D or 2D. Includes the 
'C' source code. (Windows or WIN32: $399). 

Sub Systems, Inc. 800-447-6819 

Fax: 508-352-9019 

Demos available: www.subsystems.com 
11 Tiger Row, Georgetown, MA 01833, 508-352-9020 


(continued from page 24) 
template. The best way to do this is with 
a design tool such as Borland’s Resource 
Workshop (which doesn’t come with Del¬ 
phi), or any of Microsoft’s C++ or SDK of¬ 
ferings. However, if you don’t have access 
to these, you can construct one by hand 
using an ASCII text file (look in some of 
the older Windows programming books 
for details on how to manually construct 
RC files). 

Your dialog template will contain any 
additional controls you want to surround 
the open dialog. You’ll also add a control 
(it doesn’t matter what kind) with a spe¬ 
cial ID of $45F. This control sets the lo¬ 
cation of the standard open dialog con¬ 
trols. The top left of the special control 
will be the top left of the open dialog. 
The system will keep the same distance 
from the bottom right of the special con¬ 
trol to the other controls and the edge of 
the dialog. 


This is easier to observe than to explain. 
Look at Figure 2, which is a dialog template 
that contains several controls. Note the rel¬ 
ative position between die placeholder con¬ 
trol (die empty rectangle) and the rest of 
die dialog. Figure 3 shows how the open 
dialog will use this template. Contrast this 
widi Figures 4 and 5. Notice that the dia¬ 
log template creates the placeholder con¬ 
trol without the WS_VISIBLE style. This 
hides die control. If you don’t hide it, it will 
show up on top of die standard controls. 

Your custom dialog template should 
have the following styles set: DS_CON- 
TROL, DS_3DLOOK, WS.CHILD, and 
WS.CLIPSIBLINGS. Since several of these 
styles are new to Windows 95, you may 
have to add them manually to your RC 
file (see the listings, available electroni¬ 
cally, for an example). 

Once you have a resource, you need 
to do four things to make die open dia¬ 
log use it: 


Name 

Type 

Description 

hwndFrom 

HWND 

Window handle of control 



or dialog 

idFrom 

Unsigned Integer 

ID of control or dialog 

code 

Unsigned Integer 

Type of notification 


Table 1: NMHDR structure. 

Name 

Description 

CDN INITDONE 

Initialization complete 

CDN SELCHANGE 

Selection changed 

CDN FOLDERCHANGE 

Folder changed (see text) 

CDN SHAREVIOLATION 

Sharing violation occurred 

CDN HELP 

Help requested 

CDN FILEOK 

User pressed OK 

CDN TYPECHANGE 

User changed file type 


Table 2: Open dialog notification codes. 



Figure 1: Tloe example program. 
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Dir 


Figure 2: Typical resource template. 

1. Set the OFN_ENABLETEMPLATE bit in 
the OPENFILENAME flags. 

2. Place the resource name in the IpTem- 
plaleName field (also in OPENFILE¬ 
NAME). 

3. Set your program’s instance handle in 
die hlnstance field. 

4. Include the resource file in your pro¬ 
ject. How you do this depends on the 
language you are using. 

To decorate the open box with static 
text or other nondynamic controls, just 
supply a new template. You’ll only both¬ 
er with a hook function if you need to in¬ 
teract with the dialog. 

In the more usual case, you’ll want to 
install a hook function and initialize your 
controls when the dialog sends the 
CDNJNITDONE notification. If you have 
any buttons or other controls that send 
messages, you’ll need to process those 
commands in the hook function also. 

Controlling the Dialog 

It’s easy to manipulate your custom con¬ 
trols in die hook funcuon. The hook func¬ 
tion receives a window handle as an ar¬ 
gument, but that handle isn’t the dialog 
itself. Instead, it is a child window that 
represents your customizations. This is 
true even if you don’t provide a cus¬ 
tomized dialog template. 

To interact with the existing controls, 
you’ll need to send messages to the dia¬ 
log box itself. Table 4 shows the mes¬ 
sages you can send to the dialog box. 
Some of these messages return informa¬ 
tion; others control the appearance of the 
dialog. 

Of course, you can’t send any of these 
messages to the dialog before it exists or 
after it has closed. You’ll often use these 
messages while processing a \VM_COM- 
MAND message or a notification event 
from the dialog itself. 

A Delphi Component 

If you’ve used the ordinary Delphi file- 
open component, you’ll shudder to think 
of wridng all die code to customize a bare 
file-open component. However, with a lit¬ 
tle effort, you can write die ugly mess once 
and create your own customizable open 
component, such as CustDlg.PAS (avail¬ 
able electronically). 


Preview 
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The TCustomOpen- 
Dialog component 
derives directly from 
TCommonDialog so 
it must duplicate 
much of the code 

that already exists in Figure 3: Dialog generated using the template in Figure 2. 
TOpenDialog. Al¬ 


though it would have been nice to sub¬ 
class TOpenDialog Borland made much of 
that object private. Widiout protected mem¬ 
bers to use, TCustomOpenDialog would 
have to override all die important functions 
anyway. 

All is not lost, however. Instead of sub¬ 
classing the object, I simply copied and 
modified its source code. While this isn’t 
very efficient, it does work. I removed some 
extraneous code, changed all die names, 
and added die custom code required. 


Component Highlights 

The new component differs from the stan¬ 
dard component in three ways: 

• The Execute function is different. 

• The component adds several new prop¬ 
erties and methods. 

• The component provides several custom 
events. 

If you aren’t programming in Delphi, 
pay close attention to the DoExecute 



Call us today at telephone 519/836/1291 or 
facsimile 519/836/4878 to find out more about 
the Intellicon-NT960 and other Connect Tech 
communication products 


Intellicon-NT 960 
a RISC based multi-port 
I/O subsystem for 
serial communications 

Performance of 512 serial ports with 4 

★ An on-board Intel i960 host adapters in a system 


32 bit RISC processor 
off-loads the serial I / O 
task from the main CPU 

★ Offers up to 2MB of 
on-board dynamic RAM 
for data storage 

★ Offers up to 256KB of 
on-board dual-ported 
RAM and 512KB Flash 
EEPROM for data 
storage and custom 
application programs 

★ RISC-like quad UARTS 
with 24 bytes of FIFO 
per channel provide high 
speed data communi¬ 
cations up to II5K baud 
on each port 

Hardware Flexibility 

★ The Intcllicon-NT960 
subsystem includes a 
NT960 host adapter, 
the ACM /16 external 
communications 
module, software drivers 
and manuals 

★ Provides 16 to 128 asyn¬ 
chronous serial ports 
from one PC slot 

★ Accommodates a total 


★ The ACM /16 module 
has both RJ45 and 
DB25 connectors 

★ Offers optional on-board 
realtime clock and optional 
on-board battery backup 
for the dual-ported RAM 

★ Supports 80286, 80386 
and 80486 AT bus 
architecture 

Software Flexibility 

★ Development tools 
available for custom 
development 

★ Software support for 
UNIX. XENIX. QNX. 
DOS 

Reliability 

Since 1985 Connect Tech’s 
products have become 
known for their unsurpassed 
quality and reliability. This 
tradition of providing flexible 
cost effective solutions is based 
on Connect Tech’s expertise in 
the design and manufacture 
of communication hard¬ 
ware and software. At 
Connect Tech we meet 
your objectives - by design. 


< 5 © 


Connect Tech Inc. 

‘Meeting your objectives..by design ’ 


727 Speedvale Ave. W. 
Guelph, ON NIK 1E6 


Tel: 519-836-1291 
Fax:519-836-4878 
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I highly recommend Visual Parse + + 

Larry O’Brien, Software Development 

Visual Parse++ is the only tool 
that applies the techniques of visual 
programming and RAD (Rapid 
Application Development) to lexing 
and parsing technology. Why settle 
for a text-based tool when you can: 
t See the Syntax Tree 
t See the Parsing Stack 
t See Conflict Trace Trees 
t See Grammar Rule Matches 



t See Errors and Error Recovery 
t See Regular Expression Matches 
t See the Flow of your Input Data 
t Work in one tenth the time ! 

When your design is finished, write 
your application using: 

C/C++: full support for VC+ + 
1.5, 2.x, 4.x and BC++ 4.x (16 and 
32 bit). Comes with a complete, 
100% portable class library (Unix, 
Mac, OS/2) 

Visual Basic: use the powerful 
parsing VBX/OCX 

Delphi: native Delphi support! 

Comes with drop-in parsers for 
HTML, SQL, RTF, Modula 2, C, 
C++, CONFIG.SYS, and more. 

Big claims? We back them up with a 
60-day money back guarantee. If it 
doesn't do what we say, send it back! 

Intro price: $299! 


Call (800) 988-9023 

l cmdStone 



950 Shore Crest Road 
Carlsbad. CA 92009 
Phone: ($19) 929-9778 
Fax: (619) 929-9848 
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procedure and the ExplorerHook function. 
DoExecute is the procedure responsible 
for creating the dialog box. It sets up the 
OpenFilename structure with the required 
fields (mostly from design-time proper¬ 
ties). The routine forces the dialog type 
to OFN_EXPLORER since only this type 
of dialog works with the customization 
techniques used. The procedure also sets 
ExplorerHook as the hook, and if you 
specify a dialog template ID, it stores that 
in IpTemplateName and sets the OFN_EN- 
ABLETEMPLATE flag. Notice that you don’t 
have to supply a dialog template ID if you 
don’t want to change the dialog’s ap¬ 
pearance. 

The ExplorerHook function is a simple 
window procedure. It handles four mes¬ 
sages: WMJNITDIALOG, WM.NOTIFY, 
WM.COMMAND, and WM_NCDESTROY. 
Because the function is a window pro¬ 
cedure, it isn’t part of any particular ob¬ 
ject. This poses a problem, since the code 
needs to examine properties and values 
from the object in use. If you only use 
one open dialog, that’s not a problem— 
you could hard code the value or store 
it in a global variable. However, if you 


create multiple objects, this wouldn’t 
work well. 

To solve this, DoExecute stores a point¬ 
er to the current object ( Self ) in the dia¬ 
log structure’s ICustData field. This is a 
32-bit integer that your program can use 
to store data. During WM_INITDIALOG, 
the IParam parameter points to the dia¬ 
log structure. ExplorerHook learns the val¬ 
ue of ICustData and attaches it to the di¬ 
alog window with a window property. It 
also initializes the dialog object’s Wnd 
property at the same time. 

On every call to ExplorerHook, the code 
reads the property and converts it into a 
pointer to a TCustomOpenDialog object. 
When the code detects a WM_NCDE- 
STROY (the last message a window re¬ 
ceives), it removes the property. 

The remaining code in ExplorerHook 
is responsible for routing WM_NOTIFY 
events and WM_COMMAND messages 
into user-defined events. The routine 
decodes the WM_NOTIFY code and pass¬ 
es information to the appropriate han¬ 
dler (see Table 5). Except for OnShare- 
Violation , each event handler receives 
the sending object, the current window 


Field 

Type 

Description 

hdr 

NMHDR (see Table 1) 

Standard header 

IpOFN 

Pointer to OPENFILENAME 

Dialog structure 

pszFile 

Pointer to Char 

Name of file if hdr.code = CDN_SHAREVIOLATION 


Table 3: OFNOTIFY structure. 


Message 

wParam 

IParam 

Description 

CDM_GETSPEC 

Size of 

character buffer 

Pointer to 
character buffer 

Get current file spec 

CDM_ GETFILEPA TH 

Size of 

character buffer 

Pointer to 
character buffer 

Get current file and path 

CDM_GETFOLDERPATH 

Size of 

character buffer 

Pointer to 
character buffer 

Get current folder name 

CDM_ GETFOLDERIDLIST 

Size of 

character buffer 

Pointer to 
character buffer 

Shell ID list of items 

CDM_ SETCONTROL TEXT 

ID of control 

Pointer to 
character buffer 

Sets control text 

CDM_HlDECONTROL 

ID of control 

Not used 

Hides specified control 

CDM_SETDEFEXT 

Not used 

Pointer to 
character buffer 

Sets default 
extension (no'.') 


Table 4: Open dialog messages. 


Handler 

Corresponding Message or notification 

OnlnitDone 

CDN INITDONE 

OnFileOK 

CDN FILEOK 

OnFotderChange 

CDN FOLDERCHANGE 

OnHelp 

CDN HELP 

OnSelChange 

CDN SELCHANGE 

OnTypeChange 

CDN TYPECHANGE 

OnShare Violation 

CDN SHAREVIOLATION 

OnCommand 

WM COMMAND 


Table 5: Component event handlers. 
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Figure 4: Resource template with a 
small placeholder. 


handle, the parent window handle, and 
a pointer to the dialog structure (not the 
notification structure). The OnShareVio- 
lation handler has all these parameters 
plus the name of the file that caused the 
violation. 

When the default ExplorerHook func¬ 
tion detects a notification of CDN_INIT- 
DONE, it centers the dialog. I changed that 
bit of code to respect a Boolean property 
named Center. This allows you to center 
the dialog if you like. 

The user-defined command handler ( On- 
Command ) gets control when you press 
a user-defined control. It gets the sending 
object, the current window handle, the par¬ 
ent window handle, and the control ID. 
You can use this function to respond to 
custom buttons or other controls. 

The other interesting code in the object 
provides new properties and methods (see 
Table 6). Most of these are simple short¬ 
cuts for sending the dialog messages. For 
example, the GetSpec function supplies the 
Spec property. This simply retrieves the val¬ 
ue from die dialog using CDM_GETSPEC. 

One final note on die procedures in die 
CustDlg unit: These routines rely on Del¬ 
phi 2.0’s ANSI string facility. These new 
strings (also known as “long strings”) con¬ 
vert easily to die PCbar type. This is handy 
because all of the Windows messages re¬ 
quire PChai s. If you were doing die same 
diing in an older dialect of Delphi, you’d 
need to make extensive use of StrPas and 
StrPCopy. 

An Example 

Available electronically is a sample pro¬ 
gram, Custopen, that uses the custom 
open dialog to view bitmaps, metafiles, 
and icons (see Figure 1). When you bring 
up the open dialog, it contains a preview 
button. Pressing diat button shows a pre¬ 
view of the file. The dialog also shows the 
current directory path and contains some 
custom text near the top of the box. 

You might consider putting die preview 
window direcdy on the dialog box. That 
is possible, but the component used for 
die preview window is a Delphi compo¬ 
nent and is difficult to store in a resource 
template. Instead, you would have to cre¬ 
ate a placeholder in die template and cre¬ 
ate the component dynamically at run time. 

If you borrow die PREVIEW unit to use 
in your own code, you should be aware 
of how it handles exceptions. If the user 


Name 

Type 

Description 

Wnd 

Property 

Contains window handle of user dialog 

FolderPath 

Property 

Corresponds to CDM_GETFOLDERPATH (read-only) 

FilePath 

Property 

Corresponds to CDM_GETFILEPATH (read-only) 

Spec 

Property 

Corresponds to CDM_GETSPEC (read-only) 

DefExt 

Property 

Corresponds to CDM SETDEFEXT (write-only) 

HideControl 

Procedure 

Corresponds to CDM HIDECONTROL 

SetControlText Procedure 

Corresponds to CDM_SETCONTROLTEXT 

TemplateName Property 

Name of custom template 

Center 

Property 

Determines if dialog auto-centers 


Table 6: New component methods and properties. 



Figure 5: Open dialog generated from the resource 
template in Figure 4. 


selects a nongraphic 
file and clicks pre¬ 
view, an exception 
occurs. To prevent 
this from being a 
problem, I sur¬ 
rounded the offend¬ 
ing code in NewPre- 
view with a try block 
to catch exceptions. 

However, I don’t dis¬ 
tinguish between dif¬ 
ferent types of ex¬ 
ceptions— I ignore 
them all. If you were 
using the code where you might expect 
different types of exceptions, you’d want 
to spruce up the exception handling. 

I used the standard MDI project to start 
the program in MAIN.PAS (available elec¬ 
tronically). In the CreateMDIChild proce¬ 
dure I added a call to load an image com¬ 
ponent with the specified file name. The 
odier change required is to FileNewItem- 
Click I changed tills routine to use a TCns- 
tomOpenDialog object on the form. 

To get the custom dialog template into 
the project, the MAIN.PAS file has the di¬ 
rective I SR CUSTDLG.RESl. I created CUST- 
DLG.RC using Borland’s resource work¬ 
shop and compiled it with BRC32 (the 
Borland resource compiler). The other 
functions I added to MAIN.PAS are Cus- 
tomOpenDialoglCommand (to handle the 
preview button), CustomOpenDialogl- 
FolderChange (to update the current di¬ 
rectory display), and CustomOpenDia- 
logllnitDone (to change the Cancel 
button’s text). These functions are straight¬ 
forward. 

The only thing to remember as you 
browse this code is that the dialog tem¬ 
plate is not a Delphi form; therefore, to 
set the directory text, the program uses 
SetDlgltemText. In a language like C, the 
resource compiler uses the same symbol¬ 
ic constants that the C compiler uses, so 
you use symbolic names for the control 
IDs. Although you can create const val¬ 
ues for the control IDs, you would have 
to manually manage them. Rather than 
bother with that, I simply used constants 
(99 is the directory name, 100 is the pre¬ 
view button). 


In a similar vein, I specified the dialog 
template by name, not by number. That 
way, you can simply supply a string to 
the dialog component. How you do this 
depends on which dialog editor you use. 
When you enter the dialog’s name with 
Borland’s Resource Workshop, the pro¬ 
gram will ask you if you want to create a 
symbol of that name. Just say no. 
Microsoft’s tools will automatically create 
symbols unless you surround the name 
with double quotes. As a last resort, you 
could find the .H file that the RC file in¬ 
cludes, edit it, and remove the # define 
symbol that defines the dialog name. 

In the online listings, you’ll also find 
SIMPLE.PAS. This program doesn’t do any¬ 
thing except bring up a custom open di¬ 
alog. Unlike MAIN, SIMPLE doesn’t sup¬ 
ply a custom dialog template. 

Wrap-Up 

Using a custom open dialog from Delphi 
requires some decidedly nonvisual pro¬ 
gramming. However, if you are careful, 
you can write this type of code once and 
encapsulate it in a visual way. 

If you are thinking of using any of the 
messages or techniques in this article with 
the old-style file-open dialog, forget it. 
These things only work when OFN_ 
EXPLORER is set in the options. I haven’t 
decided if I prefer using the new method 
to customize dialogs or the old method. 
One thing I have decided is that it is def¬ 
initely different. 


DDJ 
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Creating Shaped 
UI Objects 


Shape up! 

Don't be a square 

Steve Sipe 

A s the user interface of Windows ap¬ 
plications constantly evolves, many 
new applications are presenting users 
with “shaped” objects with which 
they can interact. For example, a desktop 
navigation program may present a desk 
that contains phones, file folders, pencils, 
and the like. Users can activate each of the 
associated items by clicking on its repre¬ 
sentation. 

Windows developers facing the challenge 
of creating and manipulating shaped ob¬ 
jects must strike a balance between creat¬ 
ing pure objects that don’t care about their 
shape, and objects that must be aware of 
their precise shape every time they are 
painted or when a mouse button is clicked. 

While Windows 3.x APIs only offered 
support for rectangular windows, Win¬ 
dows 95 and NT 3.51 implement an API 
function that makes creating and man¬ 
aging shaped windows straightforward. 
In this article, I present CShape, a class 
that encapsulates this function. I also in¬ 
clude two shaped objects (built with Vi¬ 
sual C++ 4.0)—a “sticky note” with a 
turned up corner (see Figure 1) that 


Steve is a developer with GE Fanuc Au¬ 
tomation in Charlottesville, Virgin a. He 
can be reached at steve.sipe@choge.com. 


demonstrates how to create a polygon 
shaped CWnd , and a “stellar calculator” 
(see Figure 2) that demonstrates how to 
create shaped custom controls and 
shaped dialog boxes. The source code and 
related files for both the stellar calculator 
and sticky-note window are available elec¬ 
tronically; see “Availability,” page 3. 

The Old Way 

Windows 3.x gave you a way to create non- 
rectangular windows, but there were sev¬ 
eral “tricks” needed to make this approach 



work. The approach consisted of creating 
a transparent window with the extended 
window style of WS_EX_TRANSPARENT. 
A transparent window is painted after any 
sibling windows underneath it are paint¬ 
ed, allowing them to show through. 

This approach sounds simple and easy 
to implement, but there is a problem. As¬ 
sume that your window displays a circle 


depicting a clock with hands. You define 
your painting code to draw the circle us¬ 
ing the EllipseO API call, create the win¬ 
dow with the WS_EX_TRANSPARENT ex¬ 
tended style, add a title bar, and then build 
and execute the program. 

So far so good. The circle and windows 
underneath appear. It gives every indica¬ 
tion of doing exactly what you want. Now, 
grab the title bar and move the window. 
This is where the problem surfaces. Trans¬ 
parent windows keep the contents of the 
windows beneath them and only update 
those contents when the windows under¬ 
neath repaint. The result is a clock win¬ 
dow with garbage surrounding the face of 
the clock. There is a way to solve this but 
it involves hit-testing the points outside 
the circle and sending paint messages to 
each of the sibling windows underneath. 
This is an awkward approach and makes 
the resizing and repainting code painful¬ 
ly aware of the shape of the window. 

Another problem with this approach in¬ 
volves processing mouse clicks. A true 
shaped window should allow the windows 
underneath to receive mouse clicks if the 
mouse button is not clicked somewhere 
in the shape of the object. A clock, for ex¬ 
ample, might process a left-button click 
to let users set an alarm. If users click out¬ 
side of the clock face, you need to pass 
the left-button click to the window un¬ 
derneath. Again, you must hit-test for the 
window underneath and forward the 
mouse message to it. 

The New Way 

Windows 95 and Windows NT 3.51 pro¬ 
vide an easier way to create shaped win¬ 
dows. They provide a new API function 
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SetWindowRgn() that allows the creation 
of windows with visible regions. A visi¬ 
ble region defines the presentation area 



Figure 1: The sticky-note window UI. 
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of the window and also determines 
which windows receive mouse clicks. 
Regions free the developer from the re¬ 
sponsibility of forcing the repainting of 
sibling windows or routing mouse clicks 
to them. The operating system automat- 



Figure 2: The stellar calculator UI. 

t ' 


ically handles these responsibilities based 
on the visible region’s shape. 

SetWindowRgnO takes two argu¬ 
ments: A window handle that sets the 
visible region, and the handle of a GDI 
region object that describes the visible 
region. Example 1 demonstrates how to 
use SetWindowRgnO to create a dialog 
box with rounded corners. 

The mjrgnWnd data member is an in¬ 
stance of a CRgn MFC class. CRgn encap¬ 
sulates a GDI region object. (A region is 
similar to a RECT structure, but has more 
shapes than just rectangular.) The CRgn class 
exposes this capability by providing meth¬ 
ods for creating rounded rectangles, poly¬ 
gons, ellipses, and so on. Region objects are 
an integral part of creating shaped windows. 

A New Class 

After experimenting with setting the 
shapes of various windows, I built a set 
of common “shape” methods to encap¬ 
sulate setting visible regions for various 
CWnd- derived windows. Unfortunately, 
classes like CDialog and CView , though 
derived from CWnd, require unique class¬ 
es derived from CDialog and CView, re¬ 
spectively, because they require different 
methods and message maps. This list of 
unique CShape classes could also expand 
indefinitely as new, unique CWnd- derived 
objects appear that would be good can¬ 
didates for shaping. Of course, a draw¬ 
back to implementing these various class¬ 
es is that the same basic shape-setting 
code is contained in each new class. 

I solved this problem by using multiple 
inheritance, which allows a class to be de¬ 
rived from two base classes. Some feel 
that multiple inheritance violates true 
object-oriented programming because a 
class might contain the definition of two 
or more objects. In my implementation, I 
view the CWnd as the object and its shape 
as nothing more than an attribute. There 
is no confusion about what the object re¬ 
ally is. Example 2 (extracted from “Stellar 
Calculator”) is the class definition for a 
shaped dialog box. 

Notice that CCalculator is derived from 
both CDialog and CShape. The CShape 
class is a base C++ class—it is not de¬ 
rived from anything (including CObject, 
more on this later). It contains several 
methods that simplify setting the shape of 
the associated window. Combining CShape 
with a CWnd- derived class is completely 
transparent except for one requirement. 
The CShape class defines a pure virtual 
function, GetHWNDO , that returns a win¬ 
dow handle. “Pure virtual” means that the 
method is not implemented in the CShape 
class, but must be implemented by any 
class derived from CShape. The CCalcu¬ 
lator class definition shows how to im¬ 
plement GetHWNDO. 
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Visual C++ fully supports multiple in¬ 
heritance. Likewise, MFC supports it, but 
with two restrictions. A class cannot con¬ 
tain two CWnd objects. For instance, a 
class derived from both CFrameWnd and 
CEdit is not legal because each of these 
classes contains a CWnd . Also, if both 
classes are derived from CObject, then 
the derived class must define how to han¬ 
dle the operators new and delete and the 
DumpO method. This is because both 
CObject classes contain these methods, 
and the compiler can’t determine which 
CObject methods to use. I chose to avoid 
this confusion by not deriving my CShape 
class from CObject This eliminates the 
need to redefine new , delete , and 
DumpO and takes nothing away from 
the functionality of the CShape class. In 
my implementation, a window’s shape is 
an attribute just like its size or location. 
The CShape class implements methods 
to modify this shape attribute and re¬ 
quires an associated CWnd object to 
make it functional. 

The CShape class that I provide encap¬ 
sulates the various region methods into a 
simple-to-use class that allows you to cre¬ 
ate various familiar shapes such as stars, 
ellipses, and the like. This class can easi¬ 
ly be extended to provide additional 
shapes. I have provided a few as exam¬ 
ples of how region objects and visible re¬ 
gions interact. 

The Shape of Things that Can't 

Combining the CShape class with top- 
level windows such as CDialog and 
CMainFrame worked well, but I also 
wanted to create shaped button controls 
in dialog boxes. Because buttons and 
text controls are just child windows, I 
assumed that it would be easy to set 
their shape. I was wrong. It seems that 
standard controls such as buttons allow 
you to set their shape, then they polite¬ 
ly set it back somewhere inside their 
window procedure. I decided to try a 
different approach altogether— creating 
simple custom controls that I could set 
the shape of and treat just like standard 
controls. 

Creating custom controls with the SDK 
begins by defining a window procedure 
and calling RegisterClass() with a \VND- 
CLASS definition that, among other things, 
contains a pointer to the control’s win¬ 
dow procedure. This window procedure 
is a standard exported C routine that is 
responsible for handling the various Win¬ 
dows messages for painting, mouse in¬ 
put, or whatever. I wanted to implement 
the same type of functionality in my 
shaped buttons, but I wanted to imple¬ 
ment it with a CWYid- derived class instead 
of a C window procedure, so that I could 
use MFC methods. I began to examine 
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how to create custom controls within the 
framework of MFC. 

The Shape of Things that Can 

Creating custom controls with MFC works 
much the same as with the SDK, but with 
a twist—when does RegisterClass() get 
called for the control and how does it get 
attached to an MFC class? The trick to reg¬ 
istering the class is to use a static mem¬ 
ber in each class that automatically calls 
a static RegisterO method. Making Regis- 
ter() a static method assures that it is 
called regardless of whether the class is 
instantiated. 

Having taken care of how to register 
the control’s class, I had one last detail to 
attend to—attaching an MFC class to a 


newly created control. I added a switch 
statement case for the WM_NCCREATE 
message to the custom control’s window 
procedure. WM_NCCREATE is sent by 
Windows just before a window is creat¬ 
ed. At this point, I instantiated the con¬ 
trol’s associated MFC class by doing a new, 
then I attached the class to the control by 
calling the MFC SubclassWindowO 
method. Subclassing causes any subse¬ 
quent Windows messages to be sent to 
my MFC class where they can be handled. 

The stellar calculator’s CCalcKey class 
demonstrates how to create a simple cus¬ 
tom control. CCalcKey uses two macros 
defined in shape.h to simplify the process 
of registering control classes and attach¬ 
ing MFC classes: 
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for C/C++ ~ 

Version 7.0 

presents Bug #578 


1 

#include <iostream.h> 



2 




3 

class X 



4 

< 



5 

public: 



6 

X( const & X ) 

{ kind = "copy"; 

) 

7 

X( ) { kind = 

"original"; } 


8 

char *kind; 



9 

>? 



10 




11 

void f( X x ) 



12 

{ cout « x.kind; 

) 


13 




14 

int main() 



15 

( 



16 

X x; 



17 

f< x ); 



18 

return 0? 



19 

} 




It um the programmer’s intent that whenever the class X is * copied' through the copy 
constructor the value of • kind • was to reflect that fact . But instead of printing "copy" it 
prints "original". Where did the programmer go wrong? Call if you need a hint, or refer 
to our web page at http.: / /www. gimpel. com. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches, 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
This price is subject to increase. 

FlexeLintfor C/C++ 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


PA add 6 % sales lax. 


©toptl Softwar® 

3207 Hogarth Lane, Collegeville, PA 19426 
CALL TODAY (610)584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 


PC-lint and FlexeLim are trademarks of Gimpel Software 



• DECLARE_SHAPECLASS() is added in 
the class definition of any class that is 
to become a custom control; see Ex¬ 
ample 3(a) and calckey.h. 

• IMPLEMENT_SHAPECLASS() is added 
in the .cpp file that implements the class; 
see Example 3(b) and calckey.cpp. 


DECLARE_SHAPECLASS() creates a 
few basic definitions that are used to reg¬ 
ister and subclass the new control class. 
IMPLEMENTSHAPECLASSO does most 
of die real work. It defines die WNDCLASS 
structure that is required to register the 
new class. It also defines a static window 


procedure pointed to by the WNDCLASS 
structure that contains the code to create 
and attach the custom control to its MFC 
class. The file shape.h contains the defi¬ 
nitions of these macros, and the files calc¬ 
key.cpp and calckey.h demonstrate how 
to use them to create custom controls. 

Now that you can register a class, you 
might ask how the new custom control 
gets created. This is the simplest part of 
all. Simply add a user-defined control to 
the dialog using the dialog editor. The 
user-defined control’s class name must 
match the name of the class from DE- 
CLARE_SHAPECLASS(). In the CCalcKey 
example, the control’s class name would 
be CCalcKey. The dialog IDD_CALCULA- 
TOR shows an example of how CCalcKey / 
custom controls are defined. Note that die 
custom control only appears as a blue rect¬ 
angle at design time, but at run time it 
takes the shape and color that you set in 
your code. 

Figure 2 shows the stellar calculator in 
action. Every object on the calcula¬ 
tor— number buttons, total display, op¬ 
erator buttons, and even the close but¬ 
ton— are CCalcKey custom controls. Run 
the calculator and click on a number but¬ 
ton. Notice diat die button’s color changes 
to red when it is clicked. Click in the in¬ 
dented space between the points of the 
star. This time the color remains yellow 
because die mouse message is outside the 
button’s visible region and is therefore au¬ 
tomatically routed to the window under¬ 
neath. 

I also provide sample code to create a 
shaped sticky note window that contains 
a turned-up corner. 

The Shape of Things to Come 

To make my shape implementation com¬ 
plete, I had one last requirement. I want¬ 
ed to be able to set the shape of OCX 
controls. Because OCX controls are based 
on CWnd objects, I assumed that I should 
be able to combine my CShape class with 
them just like any other type of CWnd. I 
derived the OCX from both COleControl 
and CShape and added OnCreate to han¬ 
dle the \VM_CREATE message. The 0/7- 
Create() method is a good place to set 
the shape of the OCX because the CWnd 
is created at this point, and this method 
is called only once for each new control. 
Example 4 shows how to set the shape of 
the OCX to a star. 

This is all that is necessary to set the 
shape of the OCX to something other than 
a boring rectangle. Keep in mind that, just 
like custom controls, the shape of the con¬ 
trol is still rectangular at design time, but 
transforms into the shape your code spec¬ 
ifies at run time. 

DDJ 


(a) 

// (NOTE: m.rgnWnd must be a data member, not on the stack because Windows 
// continues to use the region handle as long as the window object 
// associated with it exists) 

CRgn m.rgnWnd; 

(b) 

BOOL CMyDialog::OnInitDialog() 

( 

// Call the base class 
CDialog::OnInitDialog(); 

// Create a rectangular region (100x100) with rounded (30x30) corners 
m.rgnWnd.CreateRoundRectRgn(0,0,100,100,30,30); 

// Set the window's visible region to the specified shape 
SetWindowRgn(m_hWnd,m_rgnWnd); 
return TRUE; 

} 


Example 1: (a) In the header file, define a data member for the region class; 
(b) using it in the CPP implementation file, add calls in OnlnitDialog to set the 
dialog’s shape. 


class CCalculator : public CDialog, public CShape 
( 

private: 

// Any class derived from CShape must implement this method 
HWND GetHWND() ( return m_hWnd; ) 

); '** 


Example 2: Class definition for a shaped dialog box. 


(a) class CCalcKey : public CWnd, public CShape 
( 

// Declare the custom control class 
// NOTE: argument MUST match class name 
DECLARE.SHAPECLASS(CCalcKey); 

); 


(b) (various include files) 

// Implement the custom control class 
// NOTE: argument MUST match class name 
IMPLEMENT.SHAPECLASS(CCalcKey); 

(Rest of CCalcKey methods below) 


Example 3: (a) Ihe DECLARE_SHAPECLASS() macro; (h) the 
IMPLEMENT_SHAPECLASS() macro. 


int CMyCtrl::OnCreate(LPCREATESTRUCT lpCreateStruct) 

( 

// Create the OLE control (and CWnd object) 
if (COleControl::OnCreate(lpCreateStruct) == -1) 
return -1; 

// Use a CShape method to make it look like a star 
SetStarShapeO ; 
return 0; 

) 


Example 4: Setting shape of an OCX to a star. 
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Life is good at InstallShield. We’re located just outside 
Chicago. Which means that the pizza here is great. 
And by and large, most everyone is nice to work with. 

Aside from being a pretty unique collection of 
characters, were also the world leader in tools for 
enabling software deployment to all Windows platforms. 
Our products are used to distribute hundreds of 
world-class applications: Intuits Quicken, Netscape 
Navigator; Borland’s Delphi, Microsoft’s Front Page... 
you get the idea. 

If someday you join us, you’ll find that you’ll be 
challenged. (Quite frankly, we don’t have time for 
brain-numbing "filler”.) And the kinds of things you 
create will be seen and used around the world. 

Here are a few adjectives used to describe the 
people we're looking for: creative, aggressive, smart, 
entrepreneurial. If you’re interested in any of the positions 
listed below and feel that you can favorably impact our 
future, take a minute to visit our web site. If you like 
what you see, send your resume and salary requirements 
via email: jobs@installshield.com. Dorks need not apply 

Current Career Opportunities 

• Software Developers • Product Management 

• Senior Windows Developers • Quality Assurance 


Corporate Management 
Sales Management 
International Marketing 


•Technical Publishing 

• Graphics Specialists 

• Software Localization 



Writing User 
Definable GUIs 


The trick is in extending 
Visual Basic 


Troy A. Schauls 

W hen used in conjunction with 
third-party custom controls, Vi¬ 
sual Basic (VB) can solve many 
complex programming problems 
as elegantly as any other language. At 
Seattle Systems, for instance, we used VB 
and other tools to build an information- 
management system for cardiovascular 
medicine called the “Apollo Clinical 
Database System” (see Figure 1). Apol¬ 
lo, which is in use at approximately 120 
hospitals in the U.S. and Europe, is a 
complex data-warehousing, patient-re¬ 
porting, and data-analysis tool for car¬ 
diovascular medicine. 

To build the system, we used a num¬ 
ber of off-the-shelf tools, starting with 
Microsoft Access for the back-end 
database and VB for the user interface. 
We then employed controls such as Dis¬ 
tinct’s TCP/IP, Desaware’s SpyWorks, 
Sheridan’s Data Widgets, Videosoft’s VS- 
FLEX/OCX, and StorageWorks-VB to han¬ 
dle connectivity to hospital mainframes 
and patient-monitoring machines, re¬ 
trieving and presenting stored data, build¬ 
ing user-defined screens, performing on- 
the-fly data validation, and the like. 


Troy\ ci software engineer for Seattle Sys¬ 
tems. can be contacted at tschauls@hal- 
cyon.com. 


Covering all of these topics is beyond 
the scope of a single article, so I’ll fo¬ 
cus on one of the more interesting parts 
of the project—the user-defined screens 
that allow users to create and modify 
data-entry screens. This capability is pos¬ 
sible because all our Visual Basic forms 



are created, parsed, and compiled into 
a proprietary format. Only a “system 
form” is in the app’s executable file. The 
configuration files are then read in at 
run time and the controls are loaded 
from code. 

This feature underscores one of VB’s 
most seductive features—its extensibility. 
Using VB’s built-in form object and con¬ 
trol arrays, you can create new forms and 
load controls from code, much as you can 
with C and the Windows SDK. We used 
this technique in developing the Apollo 
system. 

There were a number of factors that led 
us to this approach: 


• Many sites requested the ability to ar¬ 
range the layout and define the content 
of their data-entiy forms. 

• It was expensive and troublesome to 
customize new forms for every site. 
When a hospital requested new forms, 
that also meant a new executable file. 
Having dozens of different versions of 
a program in the hands of customers 
was a maintenance nightmare. 

• The scope of our clinical coverage was 
exploding. The nearly 700 data-entry 
forms in a full installation was far more 
than could be compiled by VB. 

Though this was a good solution for us, 
this approach is not without drawbacks. 
For instance, it requires the user base to 
be fairly savvy. Users have to grasp the 
concepts of properties, forms, and con¬ 
trols, and they need a heap of thorough 
documentation. It also requires some sort 
of design environment. We considered 
writing our own, but quickly concluded 
that rewriting the VB IDE wasn't worth¬ 
while. We decided to bundle VB with 
Apollo for those sites that paid for this fea¬ 
ture. This was a major design issue that 
required extra coding. 

If your user base does not need or 
want this capability, there are still perks 
to this approach that make the extra 
coding worthwhile. For one thing, the 
implementation is modular and highly 
reusable. Even though you may never 
need to let users tweak or design their 
own forms, you could still load some 
forms from a configuration file. If the 
need for user-defined forms arises in 
the future, you’d already be most of the 
way there. External form storage also 
means a smaller executable file, and only 
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(continued from page 36) 

those forms currently in use are in 

memory. 

Setting Up the Base Form Class 

The first step to implementing user- 
defined forms is to determine which con¬ 
trols you will support. This is probably 
the single most difficult decision. You need 
to consider the following: 

• How many types of controls will the 
base class support? 

• Which properties will you support? 

• Which properties will be set by you at 
design time and which will the user be 
able to define? 

Figure 2 is a VB 4.0 form with a few 
controls on it. This is all you need to 
make up the GUI part of the base form 
class. To try this example, insert a form 
into a VB project, and name it FUDS— 
a Form object with a class name UDS. 
Place the controls on the form, setting 
each control’s Index property to 0 and 
its Visible property to False. This will cre¬ 
ate the control arcay to be added to when 
the form is loaded. Set the appearance 
properties of each control to whatever 
defaults are appropriate. In addition, you 
will need some way of calling the pub¬ 
lic functions of FUDS and the compiler 
module, such as another form with a 
couple of command buttons on it. (The 
source code in these examples uses the 
VSAwk parsing control from VideoSoft. 
If you do not have this control, remove 
the references to it and create your own 
token parsing routine.) 


Place the code from Listing One (list¬ 
ing available electronically; see “Avail¬ 
ability,” page 3) in the code window for 
the FUDS form object. This will encapsu¬ 
late in the Form object itself the code for 
reading the configuration file and loading 
die form’s controls. Note diat die one pub- 

The VB line output, 
comma-delimited 
ASCII format, is fast 
to write and fast 
to read 


licly accessible method, Create(), takes a 
string. This is the path to the compiled 
configuration file for the form you want 
to load. At run time, one call to the Cre- 
ate() method is all it takes to construct 
and show the form. 

Creating the Compiler 

The code for compiling a VB 4.0 form 
file into a tighter configuration format is 
available electronically; see “Availability,” 
page 3. Simply place this code into a reg¬ 
ular VB 4.0 code module. This code is 
also fairly modular and encapsulated. It 


exposes only one top-level function, 
SaveFormO, to the outside world. This 
function takes several arguments: the full 
path to the location in which to store 
the compiled file; the file name; a PAGE- 
INFO structure; and an array of CTLIN- 
FO structures. 

Now take a look at the format of the 
configuration file itself (demol.dat, also 
available electronically). You could choose 
any number of ways to store the file, but 
for this example, we chose the VB line 
output, comma-delimited ASCII format. It 
is fast to write, fast to read, and is far more 
compact than the original VB form file it¬ 
self. Why wouldn’t you want to read in 
the original VB form file? In one test ex¬ 
ample, die raw VB 4.0 form file was 35.4 
KB, and the compiled form configuration 
file was approximately l/10th the size at 
just 3.2 KB. 

The CompileFormFileC) routine is a 
good starting point to explore what’s go¬ 
ing on. First, two staictures (UDTs) are 
created. The variable tForm of type PAGE- 
INFO holds the general form properties. 
Each element in the array of structures 
called atCtls() holds die properties for one 
control. The raw VB 4.0 form file is 
opened and is looped through, line by 
line, until EOF. Each property line is 
parsed and stuffed into the appropriate 
variable in the structure. 

Once this method returns, if no errors 
were encountered, die strucaires in mem¬ 
ory are written to disk in the WhteForm- 
File() routine. In this routine, it becomes 
clear why we chose this format for the 
configuration file. Using VB’s Write# 
statement, variables in the appropriate 
structure are given in a list and written in 
that order—automatically comma de¬ 
limited— to the configuration file. Con¬ 
versely, the compiled file can lie read in 
again and again using the Input# state¬ 
ment, as seen in the ReadFormPageO 
routine. 

The output of WriteFormFilef) is sim¬ 
ple and compact. The first line of each 
file contains the general-form properties 
such as size, caption, and number of con¬ 
trols on the form. Each successive line 
represents one control on the form; each 
comma-delimited field represents one 
property of that control. 

By using the Write# and Input# state¬ 
ments, VB does a whole lot of parsing 
for you. VB file I/O is generally quick, 
but this extra parsing may not provide 
optimal performance. Currently, we are 
experimenting with other I/O techniques, 
such as fixed-length ASCII input and OLE 
Structured Storage (binary). 

Testing the Compiler 

To test the compiler, create a form in VB 
the usual way by sizing the form and 



Figure 1: Typical Apollo Clinical Database screen. 
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placing controls on it. Note, however, that 
for this test you don't want to place any 
controls on the form that weren’t also 
placed on the FUDS form created earli¬ 
er. It should compile, but errors will oc¬ 
cur when trying to load it from the con¬ 
figuration file. 

Save the file the usual way. VB will gen¬ 
erate a file with the .frm extension. Then 
call the SaveFonnO routine, passing the 
path and name of the VB form just creat¬ 
ed. Once SaveFonnO has returned, the 
file will be ready to load. 

Loading and Displaying the 
Compiled Form 

When the form is needed for display, 
ReadFormPageO fills the PAGEINFO and 
CTLINFO data structures, and LoadUDS- 
Form() does the work of loading the 
controls on die form. There are two items 
worth noting about the LoadUDSFonn() 
routine and the format of the compiled 
form file. First, the order of the control 
information in the compiled file is very 
important, as it denotes the parent-child 
relationships between controls on the 
form. At run time, this relationship can 
be preserved with each control’s Con¬ 
tainer property. The other aspect to note 
is that while looping through the CTLIN¬ 
FO structure array, each time a parent 


control is reached (in this case, the par¬ 
ent control will likely be a Frame) it be¬ 
comes the parent until the next time a 
Frame control is loaded. This newly load¬ 
ed Frame then becomes the parent, and 
so on. If this is not clear, take a look at 
a compiled form file. The first field in 
each line denotes its depth. For exam¬ 
ple, a parent control might have a 1, and 
the next five controls may have a 2 in 
this field. All the 2s are children of the 
control at a depth level of 1. This pattern 
continues until EOF. 

Granted, this example is simplistic. If 
your controls are several layers deep and 
you have several possible parent con¬ 
trols, your control-loading routines have 
to become a little smarter. This increased 
intelligence, however, is left up to you. 

Conclusion 

This is definitely not the speediest method 
available for loading a form. I ran some 
rough benchmarks on a 60-MHz Pentium 
with 24 MB of RAM running Windows NT 
3.51. My test form (demol.dat) covered 
about 2/3 of the screen area and had 50 
controls. It took, on average, 0.9 seconds 
to be read in from the disk, loaded, and 
displayed. 

On the other hand, if multiple instances 
of the form are loaded in a for/next loop, 



Figure 2: Minimal VB 4.0 form. 


the average loading time increased signif¬ 
icantly. Five forms took 1.5 seconds each 
to load in succession, while loading ten 
instances of this test form increased the 
average to 1.9 seconds. These benciimarks 
were all taken using the Win32 timeGet- 
Time() API function. 

The obvious moral of this story is that 
forms should be loaded one at a time, 
or in small groups, as users request to 
view them. 

The approach described here has 
proven to be quite successful and very 
popular with our users—despite the 
slightly longer loading times. If maximum 
flexibility is your application’s aim, then 
this technique may be your answer. 

DDJ 
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The Java Abstract 
Window Toolkit 


A portable GUI class 
library for applications 
and applets 

Anil Hemrajani 

O ne of the most important packages 
(class libraries) provided in the Java 
API is the Abstract Window Toolkit 
(AWT). AWT includes a complete 
set of classes for developing portable GUI 
applications in Java. It provides classes 
for basic GUI controls, containers, event 
handling, component placement, fonts, 
colors, drawing, images, sounds, and 
more. The main benefits of AWT over oth¬ 
er GUI class libraries is that Java applica¬ 
tions can run on all supported platforms 
(without recompiling or relinking), and 
Java applets can be accessed from any¬ 
where by connecting to the Internet via 
a Java-compatible browser. 

Java programs can be written as appli¬ 
cations, applets, or both. Each is created 
by compiling Java source code into byte¬ 
codes using the Java compiler (javac). Fig¬ 
ure 1 shows a sample text-editor applica¬ 
tion on Windows 95, and Figure 2 shows 
an applet version, also on Windows 95. 
Both are generated by the same Java pro¬ 
gram—TextEdit.java (available electroni¬ 
cally; see “Availability," page 3). 

Applets are invoked by a Java-compatible 
Web browser or the appletviewer utility 
(available with the Java Development Kit). 
Both require an HTML file with an <AP- 
PLET> tag that points to a Java class file. 
This file must contain a class that subclass¬ 
es from the Applet class. The Applet class 
contains the methods init(X statKX stop/X 


Anil currently provides software engineer¬ 
ing and training consulting sendees to a 
Foil line500 coiporation in McLean, VA. He 
can be contacted at anil@pathot.net or via 
http://wwwpathot.net/useis/anil/. 


and destroy(X which are invoked when an 
applet is initialized, started, stopped, and 
destroyed, respectively. These methods can 
be overridden by the subclass. 

Java applications are invoked via the Java 
interpreter by providing it the name of a 
class. The interpreter searches for the class 
file (classname.c/ass) in the directories in¬ 
dicated in the CLASSPATH environment vari¬ 
able or the current directory if CLASSPATH 
has not Ixren set. The name of the class in 
this file must match the name passed to die 
interpreter. Additionally, it must contain a 
mainQ method with the signature public 
static void main(Sthng argsllX 



The basic steps for developing a Java 
application or applet include: 

• Creating GUI components. 

• Adding them in containers. 

• Using layout managers to position com¬ 
ponents in the containers (optional). 

• Handling events generated by user input. 

Basic GUI Components 

The GUI components Java currently sup¬ 
ports include Buttons, Canvases, Radio 
Buttons, Checkboxes, Choices, Dialogs, 
FileDialogs, Frames, Labels, Lists, Menus, 
Panels, ScrollBars, TextAreas, and Text- 
Fields. TextEdit.java (which generated Fig¬ 
ures 1 and 2) uses most of these compo¬ 
nents. Components are created by using 


the new keyword. Most components can 
be created with default settings by pass¬ 
ing in values; see Example 1 (excerpted 
from TextEdit.java). 

All GUI components inherit from the 
Component class, which provides several 
methods for operations on components. 
These include checking the bounds of a 
component, getting/setting a component’s 
font, enabling/disabling the component, 
getting/setting colors, requesting/moving 
focus, hiding/showing the component, re¬ 
sizing the component, moving the com¬ 
ponent, and more. 

Containers 

AWT Containers are GUI objects that group 
components in a specified area of a win¬ 
dow. AWT provides two major types of 
containers—Windows and Panels—that 
are implemented by the Window and Pan¬ 
el classes, respectively. Both classes are 
subclasses of the Container class, which 
inherits from the Component class. Addi¬ 
tional container classes include Frame , Di¬ 
alog, and Applet. Frame and Dialog sub¬ 
class from the Window class, whereas the 
Applet class subclasses from the Panel class. 

Containers used in TextEdit.java include a 
Frame and a Panel. Figure 3 illustrates how 
tliis application uses these containers. Notice 
how panels can not only contain other com¬ 
ponents, but also other panels. For instance, 
topPanel.addC'Nohh”, urlPanel); (extracted 
from TextEdit.java) adds a panel (contain¬ 
ing choice lists and checkboxes) inside an¬ 
other panel. The line addC'North", topPan- 
elf adds another Panel object to the applet, 
which itself is a subclass of Panel. 

Since applets cannot serve as an appli¬ 
cation’s main Frame window, they require 
a browser or Java application to provide 
tliis frame window for them. TextEdit.java 
creates a frame window when it is run as 
an application, then creates an instance of 
the TextEdit class (a subclass of the Ap¬ 
plet class) and calls its init() method 
( te.initO ) just as a browser would. 

Layout Managers 

Layout Managers arrange components in¬ 
side containers and automatically reposi- 
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(continued from page 40) 
tion (and sometimes resize) them every 
time the container changes its appearance. 
This simplifies the task of figuring out ab¬ 
solute coordinates for components. Addi¬ 
tionally, this ensures that die components 
will have the best possible appearance in 
browsers and different monitor resolutions. 

AWT currently provides five predefined 
Layout Managers: 

• FlowLayout, which places components 
in a simple left-to-right order. 

• GridLayout , which places components 
in rows and columns after resizing all 
of them to the same size. 

• BorderLayout, which places the com¬ 
ponents in five areas: north, south, east, 
west, and center. 

• CardLayout, which is useful if an area 
in a window can contain different com¬ 
ponents at different times based on the 
state of the application. 

• GridBagLayout, which allows compo¬ 
nents to be placed vertically and hori¬ 
zontally without requiring them to be 
the same size. 

The alternatives to using die predefined 
layout managers include designing a cus¬ 
tom layout manager [Editor’s Note : See 
“How Do I Create a Layout Manager,” by 
Cliff Berg, on page 101 of this issue] or 
doing without them using absolute posi¬ 
tioning. Custom layout managers can be 
created by providing an implementation 


for the LayoutManager interface (abstract 
class). Absolute positioning of components 
is not recommended, especially for ap¬ 
plets that can be viewed through differ¬ 
ent browsers. 

TextEdit.java uses BorderLayout, Flow- 
Layout , GridLayout, and GridBagUiyout to 
lay out its various panels (see Figure 3). For 
example, die panel containing die font con¬ 
trols uses FlowLayout to place its controls 
from left to right with left justification; see 
Example 2(a). The panel containing die push 
buttons uses the GridLayout with settings 
of one row and seven columns (corre¬ 
sponding to die seven buttoas). GridLayout 
automatically resizes all buttons in diis pan¬ 
el to equal sizes; see Example 2(b). The ap¬ 
plet panel uses a BorderLayout to place its 
components in three of die five areas avail¬ 
able widi diis layout; see Example 2(c). 

Event Handling 

Once an application’s screen has been de¬ 
signed, you make it operational by react¬ 
ing to events generated by user input. All 
events are handled in a component’s sub¬ 
class by overriding die handleEvent mediod. 
Alternatively, event-specific methods can 
be implemented in die subclass such as ac¬ 
tion, keyDown, mouseEnter, mouseExit , 
mouseMove, mouseUp, mouseDown, and 
mouseDrag. 

Events in AWT 
are passed up in a 
component’s hierar¬ 
chy; in odier words, 


a subclass gets a crack at the event before 
its parent class does. If the event is han¬ 
dled by a class, it should return a value 
of true to indicate that the event has been 
handled, or false if the event was not han¬ 
dled. A component’s subclass can also in¬ 
voke its parent event-handler method di- 
recdy ( return super.handleEvent(evt);). 

The TextEdit class in TextEdit.java uses 
handleEvent to react to all events generat¬ 
ed by controls inside die applet panel; see 
Example 3(a). Additionally, TextEdit han¬ 
dles all events generated by die TextFrame 
class. Since TextFrame is designed primar¬ 
ily to provide a frame for die applet, it for¬ 
wards all its events to the handleEvent 
mediod in TextEdit ; see Example 3(b). 

More on the Java Ul API 

Java also provides an API for working widi 
fonts, colors, drawing, images, sounds, and 
text-based user interfaces. The Font class 
can be used for setting die font of a GUI 
component: Create an instance of die Font 
class with die font name, style (bold, italic, 
nonnal), and size, dien use die component’s 
setFontO mediod; see Example 4(a). 

The Color class provides some prede¬ 
fined stadc colors {black, blue, cyan, dark- 
Gray , gray, green, lightGray, magenta, 
orange, pink, red, ivhite, and yellow ) for 
setting the background or foreground of 


cs = new Choice(); 
ebb = new Checkbox("Bold"); 
buttonPanel = new Panel(); 
buttonPanel.add(new Button(MI_NEW)); 
ta = new TextArea(30, 80); 

Menu fm = new Menu("File"); 

fm.add(new Menultem(TextEdit.MI_SAVE)); 

tURL = new TextField(80); 


(a) fontPanel.setLayout(new FlowLayout(FlowLayout.LEFT)); 

(b) buttonPanel.setLayout(new GridLayout(1, 7)); 

(c) setLayout(new BorderLayout(1, 2)); 
addO'North", topPanel); 

add("Center", ta); 
add("South", statusBar); 


Example 2: (a) Using FlowLayout to place controls from 
left to right with left justification; (b) GridLayout 
automatically resizes all buttons to equal sizes; (c) usmg 
BorderLayout to place components. 


Example 1: Creating GUI Components with default 
settings. 
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Figure 1: Text-editor application on Windows 95. 


Figure 2: Text-editor applet on Windows 95. 
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(a) 

public boolean handleEvent(Event evt) 

C 

if (evt.id == Event.WIND0VLDESTR0Y) 
terminate ( 0 ); 

else 

if (evt.id == Event.ACTI0N_EVENT) 

(b) 

if (te != null) 

return te.handleEvent(evt); 


Example 3: (a) Using handleEvent to react to events generated by the controls; 
(b) forwarding events to the handleEvent method. 


(a) 

cbb.setFont (new Font (ebb. getFontO .getNameO , 


Font.BOLD, ebb.getFont().getSize())) ; 

(b) 

ta.setBackground(Color.blue); 


g.setColor(getBackground ()) ; 

(c) 

g.fill3DRect(0, 0, size().width, 2, false); 

(d) 

play(getCodeBaseO , "hello.au") ; 


Example 4: (a) Using the setFontO method; (b) using setColor method; 
(c) generating a 3-D look; (d) using an .an audio file. 


(continued from page 42) 
a component. Additional colors can be 
generated using RGB (0-255) or HSB (0.0- 
1.0) values. To set the background/fore¬ 
ground of a component, use the setBack - 
ground/setForeground methods provided 
in the Component class. To set the default 
color for a drawing object, use that ob¬ 
ject's setColor method, as in Example 4(b). 

AWT provides classes and methods for 
drawing lines, oval shapes, polygons, rect¬ 
angles, and rounded rectangles. Addition¬ 
ally, some of these drawing objects can 
have a 3-1) look, a highlighted look, or 
both; see Example 4(c). 

Java currently provides a limited API for 
multimedia processing. Methods are pro¬ 
vided for reading, displaying, and manipu¬ 
lating images in GIF and JPEG formats. Also, 
simple animation can lx? performed by dis¬ 
playing multiple image files or drawing ob¬ 
jects in the same or different areas of a win¬ 
dow. Tliis technique is analogous to playing 



Figin'e 3: Text-editor application/applet. 


several frames from a reel of film to pro¬ 
duce a picture in motion. Java also provides 
sound support in applets via methods such 
as play(). As of this article, only Sun’s .au 
audio files (8-bit p-law, 8000Hz, one chan¬ 
nel) are supported; see Example 4(d). 

Text-based user interfaces generally 
involve the use of standard-output, 
standard-error, and standard-input devices. 
Java provides access to these devices via 
static variables in its System class (Sys¬ 
tem.ozv/, System.err, and System.in). For 
example, a sample message can be dis¬ 
played to the standard-output device with 
System.out.println("Hello world!");. 

Compiling and Running TextEdit.java 

You can compile TextEdit.java from the 
command line by entering javac Text¬ 
Edit.java. Once a Java bytecode file 
(.class file) has been created, it can be 
copied to any supported platform and 
accessed without having to recompile or 
relink. To run a Java application (such as 
TextEdit.java), type java TextEdit. To run 
the applet version, put the HTML code 
< applet code ^TextEdit.class width=600 
height^400></applet> in a file (sam- 
ple.html, for example) and pull it up in 
a Java-compatible browser, or use the ap- 
pletviewer utility. 

Future of Java 

Java’s future is promising. It is robust, 
object-oriented, and portable (source and 
bytecode). Java comes bundled with a suite 
of classes for GUI, multithreading, net¬ 
working, file I/O, and the like. To add to 
tills, APIs for database access (Java Database 
Connectivity), more robust multimedia pro¬ 
cessing, and remote object access are in the 
works. Finally, several powerful Java IDEs 
are already on the market. 

DDJ 
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Looking For Version Control? 
See What The Experts Have Found 


UU 1 /! “Source Integrity is more than 
just a file management system. It performs 
revision control and simplifies data retrieval, 
and groups files as projects... so stop reading 
and get back to writing code. Only this time, 
take Source Integrity along; it’ll make the ride 
a lot easier.” (Thom Duncan—LAN TIMES) 


rating: ★★★★ "One of my favorite 
features is event triggers... 
Source Integrity's implementation 
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(Thom Duncan—LAN TIMES) 
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personal workspaces are supported, where 
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you, maybe diis will: over 450,000 developers worldwide use MKS 
products to help them accelerate their team’s productivity, protect 
their software assets and guarantee overall source code integrity. 

In the end, it’s your review that matters most. To find out more about the MKS advantage, check out our Web site for 
a full copy of the above articles and download our interactive Source Integrity demo, or call 1-800-613-7535, ext. 697. 




Member Netscape 
Development 
Partners Program. 



Mortice Kern Systems Inc. 

Tel: 519-884-2251 Fax: 519-884-8861 
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MKS is a registered trademark of Mortice Kern Systems Inc. All oilier trademarks acknowledged. 
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Data Compression with 
the Burrows Wheeler 
Transform 


Transformation opens 
the door to new data- 
compression techniques 

Mark R. Nelson 

I n mathematics, difficult problems can of¬ 
ten be simplified by performing a trans¬ 
formation on a data set. For example, dig¬ 
ital-signal processing programs use the 
Fast Fourier Traasfonn (FFT) to convert sets 
of sampled audio data points to equivalent 
sets of frequency data. Pumping up the bass 
or applying a notch filter is then just a mat¬ 
ter of multiplying some frequency data 
points by a scaling factor. Perform an in¬ 
verse FFT on the resulting points, and voila, 
you have a new audio waveform trans¬ 
formed according to your specifications. 

Michael Burrows and David Wheeler re¬ 
cently released the details of a transfor¬ 
mation function that opens the door to 
some revolutionary new data-compression 
techniques. The Burrows Wheeler Trans¬ 
form (BWT) traasforms a block of data into 
a format that is extremely well-suited for 
compression. It does such a good job that 
even the demonstration programs I’ll pre¬ 
sent here (available electronically; see 
“Availability,” page 3) will outperfonn state- 
of-the-art programs. 

The Burrows Wheeler Transform 

Michael Burrows and David Wheeler re¬ 
leased a research report in 1994 discussing 
work they had been doing at the Digital 


Mark is the author of The C++ Program¬ 
mer’s Guide to die Standard Template Li¬ 
brary (IDG Books, 1995) and The Data 
Compression Book, Second Edition (M&T 
Books, 1995). He can he contacted at 
http://web2.air mail, net/markn. 


Systems Research Center (Palo Alto, CA). 
Their paper, “A Block-sorting Lossless Data 
Compression Algorithm,” presented a data- 
compression algorithm based on a previ¬ 
ously unpublished transformation discov¬ 
ered by Wheeler in 1983. 

While the paper discusses a complete 
set of algorithms for compression and de¬ 
compression, the heart of the paper con¬ 
sists of die disclosure of die BWT algoridim. 



BWT Basics 

The BWT algoridim rearranges a block of 
data using a sorting algorithm. The re¬ 
sulting output block contains exactly the 
same data elements as the input block, dif¬ 
fering only in their ordering. The trans¬ 
formation is reversible, meaning die orig¬ 
inal ordering of the data elements can be 
restored with no loss of fidelity. 

The BWT is performed on an entire 
block of data at once. Most of today’s fa¬ 
miliar lossless compression algoridims op¬ 
erate in streaming mode, reading a single 
byte or a few bytes at a time. But widi this 
new transform, you want to operate on 
die largest chunks of data possible. Since 
the BWT operates on data in memory, you 
may encounter files too big to process in 
one fell swoop. In these cases, the file 
must be split up and processed a block at 


a time. The demo programs that accom¬ 
pany this article work comfortably with 
block sizes of 50 KB to 250 KB. 

To illustrate, I’ll start widi a much small¬ 
er data set; see Figure 1. This string con¬ 
tains seven bytes of data. To perform the 
BWT, die first diing you do is treat a string 
S, of length N, as if it actually contains N 
different strings, with each character in 
the original string being die start of a spe¬ 
cific string that is N bytes long. (In this 
case, the word “string” doesn’t have the 
meaning it does in C/C++ semantics, 
where it represents a null-terminated set 
of characters. In the context of BWT, a 
string is just a collection of bytes.) We also 
treat the buffer as if the last character 
wraps back to the first. 

At this point, it’s important to remem¬ 
ber that you don’t acftially make N-l ro¬ 
tated copies of the input string. In the 
demonstration program, I represent each 
of die strings by a pointer or an index into 
a memory buffer. The complete set of 
strings is arranged as in Figure 2. 

The next step in the BWT is to perform 
a lexicographical sort on die set of input 
strings; diat is, you want to order die strings 
using a fixed-comparison function. This 
means you should compare using a func- 
don similar to die C functions strcmp() or 
memcmp(). In diis high- level view of die 
algoridim, the comparison function has to 
be able to wrap around when it reaches 
die end of the buffer, so a slighdy modified 
comparison function would be needed. 

After sorting, the set of strings is ar¬ 
ranged as in Figure 3. There are two im¬ 
portant points to note in diis picture. First, 
the strings have been sorted, but I’ve kept 
track of which string occupied which po¬ 
sition in the original set. So string 0— the 
original unsorted string—has now moved 
down to row 4 in the array. 

Second, I’ve tagged the first and last 
columns in the matrix with the special 
designations “F” and “L,” signifying the first 
and last columns of the array. Column F 
contains die characters in die original string 
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(continued from page 46) 

in sorted order. So the original string “DR- 

DOBBS” is represented in F as “BBDDORS.” 

The characters in column L don't appear 
to lie in any particular order, but in fact they 
have an interesting property. Each character 
in L is the prefix character to the string that 
starts in the same row in column F. 

The actual output of the BWT, oddly 
enough, consists of two things: a copy of 
column L and the primary index (an integer 
indicating which row in L contains the orig¬ 
inal first character of the buffer). So, per- 
fomiing the BWT on the original string gen¬ 
erates die output string L, wliich contains 
“OBRSDDB,” and a primary index of 5. 

The integer 5 is found easily enough 
since die original first character of die buffer 
will always be found in column L in the 
row diat contains SI. Since SI is simply SO 
rotated left by a single character position, 
the first character of the buffer is rotated 
into the last column of the matrix. There¬ 
fore, locating SI is equivalent to locating 
the buffer’s first character posidon in L. 

Two Obvious Questions 

At diis point, diere are two obvious ques¬ 
tions. First, it doesn’t seem possible that 
this is a reversible transformation. Gener¬ 
ally, a so)l() function doesn’t come with an 


iinsort() partner that can restore your orig¬ 
inal ordering. Second, what possible good 
does diis strange transformation provide? 

Unsorting column L requires the use of 
something called the “transformation vec¬ 
tor,” an array diat defines die order in wliich 
the rotated strings are scattered through- 
out the rows of the matrix of Figure 3. 

The transfonnadon vector, T, is an array 
with one index for each row in column F. 
For a given row i,T[i] is defined as die row 
where S[i+1] is found. In Figure 3, row 3 
contains SO, the original input string, and 
row 5 contains SI, the string rotated one 
character to die left. Thus, 7T31 contains die 
value 5. S2 is found in row 2, so 7" [51 con¬ 
tains a 2. For diis matrix, die transformation 
vector can lx? calculated to lie (1,6,4,5,0,2,31. 

Figure 4 shows how the transformation 
vector is used to walk through the vari¬ 
ous rows. For any row that contains S[/], 
the vector provides the value of die row 
where S [i+l] is found. 

The Rosetta Vector 

The reason die transformation vector is so 
important is that it provides the key to 
restoring L to its original order. Given L 
and the primary index, you can restore 
the original SO. In this case, Example 1 
does die job. You can get diere from here. 


Here is the core premise of the Bur¬ 
rows Wheeler transform: Given a copy of 
L, you can calculate the transformation 
vector for the original input matrix. And 
consequently, given the primary index, 
you can recreate SO, or the input string. 

The key diat makes diis possible is that 
calculating the transformation vector re¬ 
quires only that you know the contents 
of the first and last columns of die matrix. 
And believe it or not, simply having a copy 
of L means that you do, in fact, have a 
copy of F as well. 

Given just die copy of L, we don’t know 
much about the state of the matrix. Fig¬ 
ure 5 shows L, which I’ve moved into the 
first column for purposes of illustration. 
In this figure, F is going to be in the next 
column. And fortunately for us, F has an 
important characteristic: It contains all of 
die characters from the input string in sort¬ 
ed order. Since L also contains all the same 
characters, we can determine die contents 
of F by simply sorting L! 

Now you can start calculating T. The 
character “O" in row 0 moves to row 4 in 
column F, wliich means T[4\=0. But what 
about row 1? The “B” could match up with 
either the “B” in row 0 or row 1. Which 
do you select? 

The choice is not ambiguous, although 
the decision-making process may not be 
intuitive. By definition, column F is sort¬ 
ed and all strings beginning with "B” in 
column L also appear in sorted order. 
Why? They all start with the same char¬ 
acter, and they are sorted on their second 
character, by virtue of their second char¬ 
acters appearing in column F. 

Since the strings in F must appear in 
sorted order, all the strings that start with 
a common character in L appear in the 
same order in F, although not necessarily 
in the same rows. Because of this, you 
know that the “B” in row 1 of L is going 
to move up to row 0 in F. The “B” in row 
6 of L moves to row 1 of F. 

Once diat difficulty is cleared, it’s a sim¬ 
ple matter to recover the transformation 
matrix from the two columns; see Figure 
6. And once that’s done, recovering the 



Figure 1: Sample data set. 



Figure 2: Set of strings associated 
with the buffer. 
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original input string is short work as well. 
Simply applying the code shown in Ex¬ 
ample 1 does the job. 

The Punchline 

Figure 7 shows a snippet of debug out¬ 
put taken from the test program 
BWT.CPP. Each line of output shows a 
prefix character followed by a sorted 
string. The prefix character is actually 
what is found in column L after the 
strings have been sorted. 

This section of output consists of a 
group of sorted strings that all start with 
the characters “hat.” Not surprisingly, the 
prefix character for almost all of these 
strings is a lowercase “t.” There are also 
a couple of appearances of the letter w. 

Whenever you see repetition like this, 
you have an opportunity for data com¬ 
pression. Sorting all of the strings gives rise 
to a set of prefix characters that has lots 
of little clumps where characters repeat. 

Using the Opportunity 

You could take the output of the BWT 
and apply a conventional compressor to 
it, but Burrows and Wheeler suggest an 
improved approach—a Move-to-Front 
scheme, followed by an entropy encoder. 

A Move-to-Front (MTF) encoder simply 
keeps all 256 possible codes in a list. Each 
time a character is to be output, you send 
its position in the list, then move it to the 
front. In the aforementioned example, col¬ 
umn L might start with the following se¬ 
quence: tttWtwttt. If you encode that using 
an MTF scheme, you would output the fol¬ 
lowing integers: {116,0,0,88,1,119,1,0,01. 
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Figure 3: Set of strings after sorting. 
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Figure 6: Known state after 
recovering F. 


If the output of the BWT operation con¬ 
tains a high proportion of repeated char¬ 
acters, you can expect that applying the 
MTF encoder will give a file filled with 
lots of zeros, heavily weighted toward the 
lowest integers. 

At that point, the file can finally be com¬ 
pressed using an entropy encoder, typi¬ 
cally a Huffman or arithmetic encoder. The 
example programs accompanying this ar¬ 
ticle use an adaptive order-0 arithmetic 
encoder as the final step of the process. 

And the Winner Is... 

Using the BWT as a front end for data 
compression has a result similar to that of 
simple statistical-modeling programs. An 
order- n statistical model simply uses the 
previous n characters to predict the val¬ 
ue of the next character in a string. Com¬ 
pression programs based on statistical 
modeling can give good results, at the ex¬ 
pense of high memory requirements. 

The BWT, in effect, uses the entire in¬ 
put string as its context. But instead of us¬ 
ing a preceding run of characters to mod¬ 
el the output, it uses the string following 
a character as a model. Because of the 
sorting method used, characters hundreds 
of bytes downstream can affect the or¬ 
dering of the BWT output. 

This characteristic of the BWT has an¬ 
other side effect. It means that, in general, 
the bigger the block size, the better the 
compression. As long as the data set is ho¬ 
mogenous, bigger blocks will generate 
longer runs of repeats, leading to improved 
compression. Of course, the sorting oper¬ 
ations needed at die front end of the BWT 
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Figure 4: Transformation vector 
routes S[i] to Sfi+lJ. 


t: hat acts like this:<l3X10Xl 
t: hat buffer to the constructor 
t: hat corrupted the heap, or vo 
W: hat goes up must come dovn<13 
t: hat happens, it isn’t likely 
v: hat if you want to dynamical 
t: hat indicates an error.<13X1 
t: hat it removes arguments from 
t: hat looks like this:<13><10>< 
t: hat looks something like this 
t: hat looks something like this 
t: hat once I detect the mangled 


Figure 7: Debug output from 
BWT.CPP. 


will usually have O(A r *log(A0) perfor¬ 
mance, meaning bigger blocks might slow 
things down considerably. (Although Bur¬ 
rows and Wheeler report that a suffix tree 
sort can be done in linear time and space.) 

You might also be impressed by die fact 
diat die BWT is apparendy not covered by 
any software patents. Burrows and Wheel¬ 
er, when asked, both indicated that no 
patents had been initiated by DEC. Since 
this algorithm was published in 1994, it 
may mean die technique is in die public 
domain. (Consult an attorney, however.) 

Even if die BWT is in die public domain, 
you need to be careful when selecting an 
entropy encoder for die final stage of com¬ 
pression. Aridinietic coding offers excellent 
compression, but is covered by quite a few 
patents. Huffman coding is slighdy less ef¬ 
ficient, but seems less likely to provoke in¬ 
tellectual property fights. 

A Reference Implementation 

One of the nice filings about BWT com¬ 
pression is that it’s easy to isolate each 
step of the process. I took advantage of 
that when writing die demo programs to 
accompany this article. The compression 
and decompression processes will consist 
of running several programs in sequence, 
piping the output of one program to the 
input of another, and repeating until die 
process is complete. 

Compressing a file using die demo pro¬ 
grams is done using die following command 
line: RLE input-file\BWT\AITF\RLE\ARI> 
output-file. The program files include the 
following: 



Figure 5: Known state of the matrix 
given L. 


int T[] = { 1, 6. 4. 5, 0, 2, 3 }; 
char L[] = "OBRSDDB"; 
int primary.index = 5; 

void decodeO 
( 

int index = primary_index; 
for ( int i = 0 ; i < 7 ; i++ ) 
t 

cout << L[ index 3; 
index = T[ index ]; 

) 

) 


Example 1: Implementing the 
transformation vector. 
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File Name 

Raw Size 

PKZIP Size 

PKZIP Bits/Byte 

BTW Size 

BTW Bits/Byte 

bib 

111,261 

35,821 

2.58 

29,567 

2.13 

bookl 

768,771 

315,999 

3.29 

275,831 

2.87 

book2 

610,856 

209,061 

2.74 

186,592 

2.44 

geo 

102,400 

68,917 

5.38 

62,120 

4.85 

news 

377,109 

146,010 

3.10 

134,174 

2.85 

objl 

21,504 

10,311 

3.84 

10,857 

4.04 

obj2 

246,814 

81,846 

2.65 

81,948 

2.66 

paperl 

53,161 

18,624 

2.80 

17,724 

2.67 

paper2 

82,199 

29,795 

2.90 

26,956 

2.62 

paper3 

46,526 

18,106 

3.11 

16,995 

2.92 

paper4 

13,286 

5,509 

3.32 

5,529 

3.33 

paper5 

11,954 

4,962 

3.32 

5,136 

3.44 

paper6 

38,105 

13,331 

2.80 

13,159 

2.76 

pic 

513,216 

54,188 

0.84 

50,829 

0.79 

progc 

39,611 

13,340 

2.69 

13,312 

2.69 

progl 

71,646 

16,227 

1.81 

16,688 

1.86 

progp 

49,379 

11,248 

1.82 

11,404 

1.85 

trans 

93,695 

19,691 

1.68 

19,301 

1.65 

Total: 

3,251,493 

1,072,986 

2.64 

978,122 

2.41 


Table 1: Comparison of results. 


• RLE.CPP implements a simple run-length 
encoder. If the input file has many long 
runs of identical characters, the sorting 
procedure in the BWT can be degrad¬ 
ed dramatically. The RLE front end pre¬ 
vents that from happening. 

• BWT.CPP is where the standard Bur¬ 
rows Wheeler transform is done. This 
program outputs repeated blocks con¬ 
sisting of a block-size integer, a copy of 
L, the primary index, and a special last- 
character index. This is repeated until 
BWT.EXE runs out of input data. 

• MTF.CPP is the Move-to-Front encoder. 

• RLE.CPP is useful if the output file is 
top-heavy with runs containing zeros, 
because applying another RLE pass to 
the output can improve overall com¬ 
pression. Further processing of MTF out¬ 
put will provide fertile ground for ad¬ 
ditional improvements. 

• ARI.CPP is an order-0 adaptive arith¬ 
metic encoder, directly derived from the 
code published by Witten and Cleary in 
their 1987 “CACM” article. 

The output of the compressor can be 
decompressed by applying the same al¬ 
gorithms in reverse. The command line 
that accomplishes this is UNAR1 input- 
file I UNRLE I UNMTF I UNBWT I UNRLE > 
output-file. Each of the programs here has 
a one-to-one correspondence with its 
namesake from the compression section. 

The ten source files that make up this 
program suite are fairly short, and their 
inner workings are simple. The most com¬ 
plicated programs are the arithmetic en¬ 
coder and decoder, which are well- 
documented elsewhere. 

Results 

I used the standard Calgary Corpus to 
benchmark my version of BWT compres¬ 
sion. The corpus is a set of 18 files with 


varying characteristics that can be found 
via anonymous ftp at ftp.cpsc.ucalgary.ca/ 
pub/projects/text.compression.corpus. For 
purposes of comparison, I show the raw 
size of the file, the compressed sizes us¬ 
ing the BWT compressor, and the com¬ 
pressed sizes using PKZIP with the de¬ 
fault compression level selected. 

As Table 1 shows, this demonstration 
program manages to compete well with 
PKWare’s PKZip. I consider this encour¬ 
aging in light of die fact that there should 
be plenty of headroom left for tweaking 
additional percentage points from my code. 
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EMBEDDED SYSTEMS 


A Process Group 
Manager for OS-9 


Adapting the I/O 
system to provide 
non-I/O services 

Peter C. Dibble 

A few years ago, I wrote a file man¬ 
ager called “PCF” for Microware’s 
OS-9 real-time operating system. 
PCF was designed to let most OS-9 
programs use DOS-format disks as if they 
were OS-9-format disks. While I was 
proud of my work, and used it as the ba¬ 
sis for discussing file-manager design and 
construction in the first edition of my book 
OS-9 Insights (Microware, 1994), it was 
clearly too complicated. In retrospect, pub¬ 
lishing PCF was a mistake. 

Mapping back and forth between the 
MS-DOS FAT file system and the OS-9 RBF 
file system takes a lot of code, and the OS-9 
community looked at my file manager and 
said, “I’m glad Peter did this for us. I’d 
rather not try to write one of these.” If they 
limited their concern to PCF they’d be right 
on target. It’s a mess. Unfortunately, the 
impression has spread to cover all file man¬ 
agers. I didn’t intend that, and I’d like to 
try again. Consequently, in this article, I 
present a simpler file manager— the 
program group manager (PGM). 


Peter is the author of OS-9 Insights and can 
be contacted at dibble@microware.com. 


Modular OS Design 

Although OS-9 was designed when oper¬ 
ating systems were monolithic (and proud 
of it), OS-9 has always been a collection 
of independent entities that are linked at 
run time. This is similar to the microkernel 



architecture used in many newer operat¬ 
ing systems. Where the OS components 
in a microkernel are full-strength pro¬ 
cesses, however, OS-9’s components are 
more like dynamically linked functions 
contained in named blocks of memory 
called “modules.” 

The I/O System 

Modular structure is heavily used in the 
I/O system. This allows you to change a 
system between I/O-less and I/O-rich sim¬ 
ply by varying the loaded modules. The 
OS-9 I/O system is built from four types 
of modules: 


• One system module: the I/O manager. 

• Any number of device descriptors: data 
modules containing constants that de¬ 
scribe a device. 

• Any number of file managers: executable 
modules that manage the logical struc¬ 
ture of a device. 

• Any number of device drivers: exe¬ 
cutable modules that interface similar 
hardware devices. 

lOMan 

I/O support is rooted in IOMan— the I/O 
manager. This module installs the stan¬ 
dard I/O system calls and assembles the 
resources for I/O devices and paths. 

When it initializes a device, the I/O 
manager first asks the kernel for the ad¬ 
dress of a device-descriptor module with 
the same name as the device. This de¬ 
vice descriptor contains all the constant 
values associated with the device. For 
instance, the device descriptor called 
“term” on my system starts with these 
values: 

file manager name: scf 
device driver name: sccd2401 
port address: $fff45000 

It contains many more constants that 
are used by the file manager and device 
driver. The I/O manager finds the file- 
manager module and device-driver mod¬ 
ule for the device and builds a system data 
structure called a “device table entry.” It 
then calls the device driver to initialize the 
hardware. 

When the I/O manager receives an 
open request, it finds the device table 
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(continued from page 52) 
entry for the requested device and cre¬ 
ates a path descriptor for the path. For 
this, and nearly every other operation, it 
passes control to the file manager for the 
device. The I/O manager does not ac¬ 
tually know anything about I/O. It pro¬ 
cesses operations exactly the same way, 
whether they are for a null device or an 
ATM networking stack. 

File Manager 

The file manager is responsible for the 
logical structure of I/O; it contains all the 
I/O code that does not depend on the 
particular hardware used for the device. 
If a file manager is designed correctly, it 
can be used with a 
wide range of I/O 
hardware. This leads 
to such interesting 
twists as an Ethernet 
chip mated to the file 
manager normally 
used with serial and 
parallel ports. 

The I/O manager 
was designed to man¬ 
age path descriptors 
and device table en¬ 
tries, and the inter¬ 
faces for file managers 
and device drivers are 
well suited to their 
roles. However, if you 
forget the names at¬ 
tached to things, the 
I/O manager and its children are actually 
a resource-management system—a flex¬ 
ible system for associating resources with 
processes and manipulating those re¬ 
sources. I/O is just a well-supported spe¬ 
cial case. 

For example, if the kernel’s memory- 
management system is not a good fit for 
some special requirement, a memory de¬ 
vice can add a new memory allocator. 
Once a process opens a path to the mem¬ 
ory device, it gains access to the services 
of a new memory manager located in what 
the I/O manager thinks is a file manager. 
If there is some special hardware (an 
MMU, for instance) involved with the 
memory, its control can be abstracted into 
a device driver. Provided you get by the 
I/O-related names of the module types 
and system calls, the resource-manager 
view of the I/O system opens a world of 
possibilities. 

By now, experienced OS-9 program¬ 
mers are thinking this might be easier with 
a “P2” module. Maybe, but have you 
thought about releasing resources when 
a process terminates? What if the process 
is killed? Here’s the issue: You can add 
new system calls to OS-9. Most standard 
system modules add a call or two, and 


many programmers have developed cus¬ 
tom system calls for their personal sys¬ 
tems. Unfortunately, it is hard to ensure 
that resources allocated to a process will 
be returned to the system when the pro¬ 
cess terminates. This is a sore point for 
many OS-9 programmers. 

Problem Statement 

Termination is a problem for some com¬ 
plex OS-9 systems. OS-9 allows applica¬ 
tions to intercept almost everything that 
could kill them. This allows the application 
to clean up before termination, which is 
important to processes that are part of a 
larger system. They may take some signif¬ 
icant final action such as releasing locks, 
saving exit information 
in a file, or passing 
control to another pro¬ 
cess. However, OS-9 
reserves one tiling that 
applications cannot in¬ 
tercept— the kill sig¬ 
nal. The prospect of a 
process that could only 
be stopped by reboot¬ 
ing the system is not 
acceptable. 

When a group of 
processes cooperate, 
they may share re¬ 
sources: locks, data 
modules, files, service 
processes. If they share 
resources, it is im¬ 
mensely convenient for 
the processes to know the names of the 
other processes in the group. 

Requiring processes to ask to join a 
group is reasonable and implementable. 
It’s also reasonable to ask processes to give 
notice when they leave die group, and this 
could be implemented widi die standard 
OS-9 system—except diat OS-9 can kill die 
process without nodee. This problem drives 
system designers to either add operating- 
system support for multiprocess systems, 
or find a single-process approach. 

Proposed Solution 

I decided to build a tool to help maintain 
process groups arranged in a client/serv¬ 
er architecture, a simple and popular way 
of organizing a group of processes. Lines 
of communication in a client/server orga¬ 
nization all go between a client and the 
server. The server in this structure wants 
to know which processes are its clients, 
and it would be nice if the clients can be 
told if the server goes away. Under OS-9, 
this is done in at least three ways: 

• Make the server a system service, prob¬ 
ably part of the I/O system. 

• Build a system service diat notifies pro¬ 
cesses when odier processes terminate. 


A PGM-like file 
manager could let 
processes leave 
something like 
a will 
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Stable as Ever 

Software drivers and sources for: 

• 3COM: 3C509 

• SMC: WD803, WD8216 

• Novell: NE2000 compatibles 


For systems with custom interfaces 
or unsupported cards, the TNT 
ToolSuite has solutions to make it 
easy to create your own. 

Serial/Dial-up Support— 
Lots of Horsepower 

When designing remote monitoring 
systems, your system can be 
connected to a telephone 
in order to dial up a 
host computer directly 
or via an Internet 
Service Provider (ISP). 
Either way, it saves 
you money! 

ET5 Web 
Connection— 

Rhead of the Pack 

Phar Lap provides all of the required 
Web technology including an HTTP 
server (Web server) and an HTML 
on-the-fly library for converting raw 
data into HTML pages for the Web or, 
if you prefer, just part of your cus¬ 
tomer’s Intranet. 


Network Protocols 
Supported — 

Putting You on Track 


TCP 

IP 

UDP 

ICMP 

ARP 

RARP 

DNS 

HTTP 

FTP 

TELENET 

HTML 



As you can see, Phar Lap’s TNT 
Embedded ToolSuite, Realtime 
Edition version 8.5 SDK has it all: 
development tools, a Realtime ETS 
Kernel, and ETS TCP/IP. So stop 
horsing around and visit us at the 
“World’s Smallest Web Server” URL 
http://smallest.pharlap.com or call a 
Phar Lap sales representative today! 


( 617 ) 661-1510 



Embedded Development—Simply on Target’" 



Phar Lap Software, Inc. 60 Aberdeen Rvenue, Cambridge. MR 02138 Tel: (617) 661-1510 Fax:(617)876-2972 

CIRCLE NO. 99 ON READER SERVICE CARD 






Run 

Microsoft 

MS-DOS* 

from 
ROM 


7~/?e One-Stop Sojn^ce 

AnnaSoft has everything you need to 
port MS-DOS to your embedded system. 

PromKit™ converts any MS-DOS version 
to an EPROM image, or if you want to 
execute directly from ROM, get Microsoft 
MS-DOS ROM Version development kits 
and licenses from us. 

AnnaBios lets you customize your BIOS 
while still retaining full MS-DOS capability, 
and SSi SoftProbe is a perfect debugger 
that works with all the above. 


Licensing 

And, as an OEM you can license any 
version of MS-DOS, Windows® (including 
95 and NT) and other Microsoft system 
support products directly from AnnaSoft! 

Support 

To wrap it up you’ll get on-line 
technical support from designers who 
have been there. Call us toll free for all 
the facts. 


1-800-462-1042 



We’re here to help 

11838 Bernardo Plaza Court 
San Diego, CA 92128-2414 
(619) 673-0870 • Fax: (619) 673-1432 
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(continued from page 54) 

• Use a watchdog trick. For instance, you 
have each process update a time stamp 
in shared memory every few seconds. 
If a process’s time stamp falls signifi¬ 
cantly behind, it’s probably dead. 

The first alternative appeals to pro¬ 
grammers who like the sense of power 
that comes from writ¬ 
ing system-state soft¬ 
ware. It is the only 
good alternative when 
the server needs to 
control preemption 
and interrupts, or 
when there are stren¬ 
uous performance re¬ 
quirements. 

Watchdog tricks are 
attractive, too, if you 
want to stay out of 
system state, but they 
are an unhappy 
choice. System de¬ 
signers who choose 
to update time stamps 
frequently invest a lot 
of CPU time; those 
who choose to update the time stamps 
infrequently won’t notice a process’s 
death for a long time. 

OS-9 has seen a couple of good stabs 
at an exit-notification service. People have 
installed an accounting-system call and 
used it to signal processes when other 
processes die. That is a good solution, but 
it costs performance on every fork and 
exit, even those that have nothing to do 
with the process group. It’s also inflexi¬ 
ble. OS-9 likes to have all its kernel ex¬ 
tensions installed at boot time. And there 
is a conflict problem if several modules 
all install an accounting extension. 

My solution is to use a file manager. 
The important fact here is that the process- 
termination code in the kernel calls the 
I$Close I/O service for each path the ter¬ 
minating process had open. I require that 
each client open a path to my file man¬ 
ager. That gives my system a mechanism 
that reliably gives the file manager con¬ 
trol when any client exits. 

I call the file manager PGM (short for 
process group manager). It implements 
the following services: 

Create. A function called from the server. 
A process that creates a PGM device de¬ 
fines itself as a server on that device. 

Open. A function called by each 
client. The PGM manager queues a 
NE\V_PATH message for the server, and 
only returns to the client when the serv¬ 
er responds. 

Close. When a client closes a path that 
was opened (as opposed to a duplicate 


of another path), the server is notified 
with a signal and a message. When the 
server closes its path, PGM notifies any 
clients that requested notification on serv¬ 
er death. 

SetStat. Only SS_SSig is supported. 
For clients, this tells the file manager to 
send the caller a signal if the server ex¬ 
its. It also tells the file manager which 
signal value to use. If 
the server uses the 
SS_SSig setstat, it 
changes the value of 
the signal PGM will 
send it when a client 
opens or closes a 
PGM path. 

GetStat. Only SS_ 
Ready is supported. It 
returns success if there 
is at least one message 
pending for the path. 
It returns E_EOF (end 
of file) if it is called by 
a client, or if it is called 
by the server and 
there are no messages 
ready for reading. 
Read and ReadLn. 
These calls are only permitted from the 
server and return messages with a defined 
structure: 

int message_type 
processjd client_process_id 

If the message is NEW_PATH, it means 
that a new client just opened a path to 
PGM. The server should decide whether 
it will permit the connection, and write a 
message to PGM telling it to accept or re¬ 
ject the request. 

If the message is CLOSED_PATIT, it 
specifies the process ID of a client that 
just closed its PGM path, either explicitly 
or by dying. 

Write and WriteLn . These are used by 
the server process to tell PGM how to han¬ 
dle a client connection request. There are 
two possible message types: ACCEPT. 
CONNECTION and REJECT.CONNEC- 
TION. PGM allows the corresponding 
Open request to return with a suitable re¬ 
turn code. 

Sample Use 

PGM is designed to sit above a 
client/server process group and publish 
obituaries. Each process in the group 
must join by opening a path to the 
group’s PGM device. The entire file man¬ 
ager contains about 900 lines of C, plus 
assorted header files. It is available at 
http://www.microware.com and from 
Diy(see “Availability,” page 3). It is freely 
usable with the usual restrictions about 
credit and warranty. 


0S-9 has always 
been a collection of 
independent entities 
that are linked at 
run time 
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(continued from page 56) 

The server must join the group first. 
It uses the I$Create system call, see List¬ 
ing One (listings begin on page 62), to 
identify itself as the server and initialize 
the group. 

The typical event-driven server will in¬ 
stall a signal-intercept routine using code 
like that shown in Listing Two, and ask 
PGM to send signals for new-client and 
client-death events. 

Listing Three shows one way to main¬ 
tain the server’s list of clients. This code 
reads a message from die PGM path, dien 
executes different routines depending on 
whether it reads a NEW_PATH message 
or a CLOSED_PATH message. CLOSED_ 
PATH messages just cause manage_clients 


to update its client list. NEW_PATH mes¬ 
sages require a response, so manage _ 
clients writes a message back to the PGM 
path telling it how to respond to the 
client’s I$Open request. 

The client code in Listing Four is simpler 
dian die server. It must open a padi to PGM 
and deal widi the response from die serv¬ 
er. It may ask to lie told if the server exits. 

Data Structures 

'file I/O manager maintains three data 
structures that might interest the file 
manager: 

• A device table entry that contains point¬ 
ers to the modules and structures asso¬ 
ciated widi the device. 


• Device static storage that contains data 
associated with the device. Device stat¬ 
ic storage contains diree sections, one 
eacli for die I/O manager, the file man¬ 
ager, and the device driver. 

• A padi descriptor. The I/O manager cre¬ 
ates one of these for each open path. 
There can be many padi descriptors as¬ 
sociated with each device. The path 
descriptor contains sections for die I/O 
manager and the file manager. 

PGM doesn’t need to refer to the de¬ 
vice table entry, and we only use the de¬ 
vice static storage as a fast way to find the 
server’s path descriptor. 

The server’s path descriptor is the 
base for three singly linked lists. The 
client list contains the path descriptors 
from the clients. The message queue 
contains path descriptors that are trying 
to open, but haven’t yet been seen by 
the server. The reply-pending list con¬ 
tains path descriptors that the server has 
seen but has not accepted or rejected. 
Figure 1 shows how PGM structures are 
connected. 

Implementing PGM 

PGM executes Listing Five when a client 
opens a padi. First, it checks a field in the 
device static storage to see if the device 
has a server. If it does not, open() returns 
the E_PNNF error immediately. If a serv¬ 
er is registered, open() initializes the path 
descriptor. Stamp_path marks the path 
descriptor so diat no matter how die padi 
is duplicated and inherited by other pro¬ 
cesses, PGM will know where it was orig¬ 
inally opened and will not bodier die serv¬ 
er with false alarms as duplicates of the 
padi are closed. Send_msg signals the serv¬ 
er that there is a NE\V_PATH message 
waiting to be read. 

Once the server has been notified, 
open() needs to wait for the server to 
respond. If the server was the only thing 
that could awaken the client, this would 
be simple, but we have no control over 
diis. PGM must appropriately handle odi- 
er signals that might be sent to the client 
process during this interval. Some file 
managers are sloppy here; they won’t 
stop waiting until they get the response 
they want. These are easy to write, but 
they are not responsive in a signal- 
driven system. 

The _os_sleep(zero) function returns 
when die process gets a signal. Depend¬ 
ing on die signal and the state of the padi, 
open() chooses one of three options: Ig¬ 
nore die signal and sleep some more, note 
that the operation is complete and return, 
or note that die operation is incomplete 
and return anyway. 

If a path descriptor is in the client list, 
the server has accepted the connection, 
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(continued from page 58) 
and open() can return. If the process is 
condemned, it has Ix^en killed, and should 
leave as soon as possible. Since the path 
is not yet in the client list, we can just 
clean up and leave. If it is in the client list, 
the server will need to be told about this 
death; that’s why the loop doesn’t check 
the status of the process until it has 
checked the status of the connection. If 
open() returns SUCCESS, the path will be 
marked open and the process-termination 
code will call close(). If open() returns an 
error, the path will not be marked as open, 
and it will not be closed. 

“I/O deadly” signals are supposed to 
break out of I/O operations, so any I/O 
code that takes significant time should 


look for them. OpenO follows this rule. It 
looks for deadly signals every time it be¬ 
comes active, and returns to the caller— 
reporting an error— if it gets one. 

Listing Six is executed when a client 
closes a PGM path. By the time control 
gets here, PGM has already determined 
that this is the client that opened the path. 

First the client-close routine checks to 
see whether the path has become a dead 
end. That would signify that the server 
is gone. Client paths are still open, but 
they are useless. These paths can be 
closed, but any other operation on them 
will fail. 

The close routine removes the client 
from the server’s client list and sends the 
server a message telling it that the client 


has closed its path. This Send_msg() 
function call is the reason PGM exists. 
This is where the server is notified about 
client deaths. After it has sent the mes¬ 
sage, the open() function sleeps stub¬ 
bornly. Normally, a file manager should 
be willing to return quickly on some sig¬ 
nals. PGM’s open() code demonstrates 
good citizenship in this respect. Close() 
is another story: PGM will not return un¬ 
til it has delivered its message to the serv¬ 
er. The function keeps looping through 
the unbounded sleep until PGM indi¬ 
cates that the server has received the 
CLOSED_PATH message by changing the 
preset return code. 

The sewer-exit code is similar, except 
that it includes a substantial amount of 
code that disassembles the linked lists 
rooted at the server’s path descriptor, 
notifies all the clients that care about its 
death, and generally destroys everything 
that the file manager has built for the 
server. 

The ReadO entry point in PGM does 
some error checking, then calls the func¬ 
tion in Listing Seven. 

Read_action first pulls a path de¬ 
scriptor out of the message queue 
(where open() or closef) put it). It builds 
a message in the caller’s buffer using the 
action and the process ID from that path 
descriptor. If the message is a NE\V_ 
PATH message, readjaction moves the 
path descriptor to the reply-pending list, 
then returns to the server. The process 
waiting in its open() call will not be re¬ 
leased until the server writes a message 
telling PGM how to dispose of its re¬ 
quest. 

When the server reads a CLOSED_ 
PATH message, PGM can wake the pro¬ 
cess waiting in closeO and return. 
There’s no need to handshake on a close 
request. 

OS-9 turns preemption off for file 
managers. Some of them turn it back on, 
but PGM is so simple that it seems point¬ 
less. With preemption off, the kernel 
will only timeslice PGM when it exe¬ 
cutes F$Sleep. Since PGM doesn’t have 
interrupt-driven device drivers, it doesn’t 
even have to worry about sharing data 
structures with them. This simplifies life 
greatly. PGM needs to leave data struc¬ 
tures consistent when it returns or 
sleeps, but other than that, it can ignore 
the usual concerns about atomic oper¬ 
ations. 

For demonstration, I’ve started to make 
PGM preemptable by masking interrupts 
during a few critical routines. Up to alx)ut 
200 clock cycles, masking interrupts im¬ 
poses no important penalty on a 68000 
(slow instructions already impose that 
much delay on interrupt service). Unless 
there are a lot of clients, the interrupt 
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Figure 1: PGM data structures. 


masking in PGM probably stays within the 
200-cycle boundary. 

On the 68xxx (which I used for this), 
the interface to file managers is specified 
in assembly language. I chose to write die 
bulk of the code in C, so I wrote a little 
assembly language to bind to the inter¬ 
face. It replaces the usual jcstart code; 
(available electronically; see “Availability,” 
page 3). 

This glue reflects my simplistic approach 
to C-language file managers. I provide 
only parameters and automatic storage. 
There is no support for stack checking, 
and static memory of all kinds is passed 
in through parameters. It’s possible to give 
die file managers a type of static storage 
by doing the right thing with die a6 reg¬ 
ister, but I find that opening that door 
leads to trouble. 

On the other hand, some of my earlier 
file managers include glue for the system 
calls they use. The system-call bindings 
in the Ultra C library (the Ultra C/C++ 
compilers are included in the OS-9 de¬ 
velopment toolset) no longer use stadc or 
global memory such as errno, so PGM 
uses the standard bindings. 

Putting it Together 

PGM needs a device driver and a device 
descriptor. Since PGM doesn’t deal with 
a real device, die driver and descriptor are 
trivial, but IOMan insists on them. 

For the device driver, I use null (die de¬ 
vice driver that looks like a serial device 
but does nothing). Since it does nothing, 
it’s safe for this kind of file manager. The 
only concern is that null thinks it is being 
called by the SCF file manager. It leaves 
enough space in device static storage for 
SCF’s file-manager static storage. Since 


PGM uses much less memory than SCF, 
we can live with this. 

The device descriptor (available elec¬ 
tronically) contains enough to make 
IOMan happy. Each PGM device needs a 
unique name and port address. They all 
use die same file manager and device driv¬ 
er. The rest of the fields are pro forma. 

Room for Improvement 

PGM can be improved by making it pre- 
emptable, especially if it stops masking 
interrupts, and the restriction to one serv¬ 
er per PGM device could be dropped if 
PGM accepted path lists with at least one 
level after the device name. Features can 
be added to PGM to better suit it to par¬ 
ticular servers. There might even be cas¬ 
es where PGM can do some common- 
resource management that the server can’t 
handle. 

It would be interesting to make PGM 
even more general. The original problem 
was that processes couldn’t reliably get 
control when killed. Perhaps a PGM-like 
file manager could execute a carefully con¬ 
strained set of commands that would let 
processes leave something like a will. 
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OS-9 


Listing One 

•define POUJOTICSJAME /SHRVER/DESC 
if{(err » _089_create(PGM.DEVICE.NAKE. 

PAM-READ { FAM_WRITS, (path. S.IPRH)) != SUCCESS)( 
fprintf(atderr P "/«: failed in create. Error /u\n", 
argv(0], err); 
exit(err): 

) 


Listing Two 

void catcher(aignal.code sig) 

( 

if(sig == PGM.SIGNAL) 
manage_clients(); 

_ 08 _rte(); 

) 

/* Install catcher() to catch any signals */ 

_os_intercept(catcher. _glob_data): 

if((err = _os_ss_sendsig(path, PGM.SIGNAL)) 1= SUCCESS)( 

fprintf(stderr, M /s: ..._sendsig(path, /u) got error /u\n", 
argv[0]. PGM.SIGNAL. err); 
exit(err); 

) 


listing Three 

void nanage.clients() 

C 

u_int32 size; 
pgja_ne8sage_t nsg: 
error-code err; 
size ** oizeof(asg); 

if((err = _os_read(path. (nag. Seize)) 1= SUCCESS)( 

/* Probably a logic error */ 

} else switch(msg.action_code){ 
case NEW.PATH: 

if(client-disposition (nsg. process) REJECT)( 

nsg. action.code ° REJECT-CONNECTION; 
if((err = -OS_write(path, (msg, (size)) 1= SUCCESS){ 

/* Probably a logic error ♦/ 

) 

) else { 

nsg.action.code = ACCEPT.CONNECTION; 

if ({err = _os_write(path, (msg, (size)) !* SUCCESS)( 

/* Probably a logic error */ 

) 

/* Take note that a client just joined us */ 
break: 

case CLOSED-PATH: 

/* Take note that the client left us */ 
break; 
default: 

/* Another logic error. There are only two possible messages /♦ 
break; 

) 

) 


Listing Four 

/♦ Sample Client code ♦/ 
path_id path; 

void catcher(signal-code sig) 

( 

if(sig == PGM-SIGNAL)( 

/* The server exited! ♦/ 

) 

_os.rte(); 

) 

void main(int argc. char ♦♦argv) 

( 

error.code err; 
extern void *_glob_data; 

-os_intercept(catcher. _glob_data); 

if ((err » _ os-open (PQLDEVICE-NAME, 0. (path)) l« SUCCESS) ( 
if(err BCONNRBFUSED)C 

/* The server won't talk with us! ♦/ 

) else ( 

/♦ Something else went wrong. Check whether client is running. ♦/ 

) 

) 

/♦ Ask to be signaled if the server exits ♦/ 
if((err ° .os-8S.sendsig(path, PGM-SIGNAL)) 1= SUCCESS)( 

/♦ The server's probably not running yet ♦/ 

) 

printft"Client: /u completed open...\n", _procid): 


Listing Five 

status.type open(const Pathdesc pd, 

REGISTERS ♦ const regs, 
const procid ♦ const procd, 
const sysglobs ♦ const globals) 

( 

pgmstatic * const devstatic » 

(pgmstatic ♦ const)pd->path.pd_dev->V_stat; 


Pathdesc server.pd: 
error_code err: 
signal-code sig; 
u_int32 zero; 

if(devstatic->server_path = NULL) 
return E.PNNF: /* Not found */ 
pd->pgmpvt.flags = PGM.CLIENT: 
stamp-path(pd, procd); 

server.pd = devstatic->server_path; 
pd->pgmpvt.server-path = server.pd; 

/♦ set default error message ♦/ 
pd->pgmpvt.rval = E_SIGNAL; 

/♦ Send message to server ♦/ 

Scnd_osg(NEW.PATH, pd); 
doC 

zero = 0; 

_os9_sleep(&zero); 
if(in_client_lst(pd))( 
pd->pgmpvt.rval = 0: 
break; 

) 

if(condenned_proc(procd))( 

clean_me.up(server.pd, pd); 

return 1; /♦ Any value will do. we’re dead ♦/ 

) 

if((sig = got_signal(procd)) != 0) /♦ Wasn't a wakeup sig ♦/ 

if(sig < SIGDEADLY)( 

clean_me_up(server.pd, pd); 
return sig; 

) 

)while(pd->pgmpvt.rval = E.SIGNAL); 

skip_nane(regs); 

return(pd->pgmpvt.rval): 


Listing Six 

status-type ClientClose(Pathdesc client.pd, 

REGISTERS * const regs, 
const procid * const procd, 
const sysglobs ♦ const globals) 

( 

u.int32 ticks; /* For _os9.sleep() ♦/ 

if(client_pd->pgmpvt.flags & PGM.DEADEND) 

/♦ The server is dead. Leave quietly */ 
return(SUCCESS); 

remove.from.client_list{client_pd); 

There will be no messages or pendings for this path in the 
server's lists. If there were, this process would be 
sleeping somewhere else in PGM, and not busy closing. ^ 

/♦ set default error message ♦/ 
client.pd->pgnpvt.rval = E.SIGNAL; 

/♦ Message and wake server ♦/ 

Send_msg(CLOSED-PATH, client.pd); 
do( /♦ 

Don't let the closing process escape 
until the server sees it (or exits). 

*/ 

ticks s 0; _os9_sleep((ticks); /♦ Wait for server read •/ 

)while(dient_pd->pgmpvt.rval == E.SIGNAL); 

retum(dient_pd->pgmpvt.rval); 


Listing Seven 

status.type read.action(Pathdesc server.pd, 

REGISTERS ♦ const regs) 

( 

Pathdesc client.pd; 

pgm_message_t * const msg-buffer ° regs->a[0); 

client.pd = dequeue.msg_q(server.pd); 

/* send the waiting message to the server ♦/ 
mag_buffer->act icn.code = client.pdOpgmpvt.action: 
msg_buffer~>procesB = client_pd->poth,pd.cpr; 

if(client.pd->pgmpvt.action = NEW.PATH) 

add_to_pending_lst(server.pd, client.pd); 
else if(client_pd->pgmpvt.action **» CLOSED-PATH){ 
client.pd->pgnpvt.rval = 0; 

/* Wake the closing process so it can finish the close ♦/ 
.os.send(client_pd->path.pd.cpr, SIGWAKE); 

) 

regs->d[l] = sizeof(pgn-message.t); 
return SUCCESS; 
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ICROPROCESSOR. WE TOOK A 


SRENT APPROACH. 


Introducing 
Distributed Emulation. 

It isn’t just another new emulator. It’s 
actually a whole new emulation strategy 
from the Hewlett-Packard Company. 

And we think it’s exactly what you’ve 
been looking for. Because it’s adaptable 
enough to give you support for the latest 
microprocessor technologies as they come 
along. Without burning out. 

How’d we do it? We broke emulation 
down into its three primary functions — 
Real Time Analysis, Run Control, and 
Download & Development — and 
“distributed” those requirements into 
separate components. 

Now each time you need support for a 


new processor, you simply buy a different 
lower-cost processor support package. 

In most cases, that’s all you replace. The 
other components are used again and 
again. You’ll be able to support new 
microprocessors long before traditional 
emulators become available. 

All told, it’s the only practical approach. 

You get support for more processors, 
sooner than ever before. 

And in the face of a rapidly 
evolving microprocessor 
environment, that’s important. 

To see how Distributed Emulation 
can help you keep pace with the latest 
microprocessors, call us at 1-800-452-4844, 
Ext. 1983. We’ll show you the light. 

There is a better way. 
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NETWORKED SYSTEMS 


Implementing a Web 
Shopping Cart 


Online transactions 
in Perl 


Chris Baron and Bob Weil 


A s the World Wide Web makes the 
transition from an academic com¬ 
munication channel to a commercial 
medium, the demand for new ways 
to conduct transactions increases. The rich 
graphics and hypertext environment of die 
Web make the presentation of products 
and services easy and efficient. Coupled 
widi built-in support for fill-in forms and 
platform-independent client-server com¬ 
munications, you’d diink the Web would 
be the ideal commerce channel. Howev¬ 
er, die nature of the Web and HTTP is not 
well suited to die type of transactions re¬ 
quired for online shopping, particularly 
die virtual “shopping cart” metaphor often 
seen on Web sites today. In this article, 
we’ll examine the components of an on¬ 
line catalog, focusing on a virtual shop¬ 
ping-cart system and some ways around 
the shortcomings of HTTP. 


Chris Baron is director of programming 
and Bob Weil is a partner at The Hyper- 
tising Network, creating next-generation, 
marketing-driven websites. Bob can be 
reached at egraphic@ix.netcom.com, Chris 
at cbaron@egrafx.com. 


What's in the Cart? 

The shopping-cart interface is only one 
part of an online catalog and ordering sys¬ 
tem. In general terms, an online catalog 
consists of die following: 



1. A database of text and graphics de¬ 
scribing die items in the catalog. 

2. An efficient mechanism to display the 
items on demand. 

3. A process to collect shipping and pay¬ 
ment information. 

4. A method of tracking items the user 
wishes to purchase. 

3. A way to identify the user, and a way 
to group a series of HTTP requests into 
a single “session.” 

The Web and HTTP are very good at 
die first two points. Most items can be suf- 
ficiendy displayed with HTML, embedded 


graphics, and hypertext links. For a large 
number of items, a database of text and 
graphics should be created and the pages 
generated programmatically on-the-fly to 
reduce storage and maintenance re¬ 
quirements. The collection of shipping 
and payment data is also easily imple¬ 
mented over the Web by using <FORM> 
and related tags. 

Points four and five are not well sup¬ 
ported by the HTTP protocol due to its 
stateless and connectionless nature (see 
“Hypertext Transfer Protocol—HTTP/1.0 
Specification,” Internet-Draft 05, Internet 
Engineering Task Force (IETF), February 
19, 1996). A Web page consisting of 
HTML-formatted ASCII text and several 
graphics is transferred as a series of dis¬ 
crete request/response transactions be¬ 
tween the browser and the HTTP server 
rather than as a continuous connection. 
However, neither the client nor server 
maintain any knowledge of the state of 
the previous or other connections. This 
provides an efficient method for servers 
to handle hundreds or thousands of si¬ 
multaneous requests. When there is a need 
to maintain state information over ex¬ 
tended periods (as in the current case), 
additional data must be stored somehow: 
either in the browser, server, or both. Sev¬ 
eral methods for transmitting state data 
over the Web have been developed. The 
three we’ll discuss are of the following: 

• The type=hidden attribute of HTML 
forms. 

• The Netscape “cookie” method (in 
which a “cookie” containing state data 
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(continued from page 64) 
is passed along in the HTTP request- 
response dialog). 

• Using a database to store the current 
state on the server. 

Listing One (listings begin on page 83) 
is an online-catalog system called “Mini¬ 
shop” implemented in Perl. For maximum 
compatibility, we used Perl 4 and tried to 
make the code clear and accessible by 
avoiding opaque Perl-isms. The source 
code for Minishop Is available electronically 
from DDJ (see “Availability,” page 3) and 
from our site at http://www.egrafx.com/ 
minishop/. 

A single script generates all the HTML 
pages for the shopping system. When 
called with no parameters, as in an initial 
call, it produces a catalog index page list¬ 
ing all of the items in the database (Fig¬ 
ure 1). The catalog data is stored in a Perl 
associative array with the part number as 



Figure 1: Minishop catalog display. 



Figure 2: Minishop catalog page. 



Figure 3: Minishop shopping-cart 
display. 


the key. The data is a colon-separated 
string containing the price and other data 
about the item. A production system 
would also include descriptive text about 
each item and references to one or more 
graphic images or sound files. 

Selecting an item name displays the 
detailed catalog page for the item using 
the &show_item_page subroutine. But¬ 
tons are provided to show the current 
contents of the shopping cart, empty it, 
or go to the checkout page. Figure 2 
shows a detailed catalog page. In a pro¬ 
duction system, large numbers of similar 
pages could be created in real time us¬ 
ing a template. During the real-time gen¬ 
eration of the page, the item name and 
other descriptive data are inserted into 
the template. Several of the systems list¬ 
ed at the end of the article use this 
method to generate their catalog pages, 
thus eliminating the need for many sim¬ 
ilar but slightly different HTML pages. 

The current contents of the shopping 
cart are displayed by calling the Scshowjcart 
subroutine, which generates the display in 
Figure 3. 

Finally, when users are ready to pur¬ 
chase the selected items, they are shown 
the page generated by the &check_out 
subroutine. This page allows users to re¬ 
view the items selected, and calculates the 
total bill along with tax and shipping 
chaiges. Address and payment information 
are also collected on diis form. In many 
current systems, die specifics of the user’s 
locadon and desired shipping mode would 
be collected first to allow proper calcula¬ 
tion of sales tax and shipping charges. In 
our simple system, we’ve combined these 
steps into the single page in Figure 4. 

Basic systems simply collect the data 
from the form and send die order infor¬ 
mation to the sales department via e-mail 
or fax without validation, perhaps en¬ 
crypted for security. Advanced systems 



Figure 4: Minishop checkout page. 


minimize the man-hours spent on each 
order by automatically validating credit- 
card data, initiating production activities, 
and updating inventory databases. 

I'm Hidden (But You Can Still See Me) 

The first of three methods we’ll use to 
store the contents of the shopping cart 
is a type=hidden attribute of an HTML 
<INPUT> field. Example 1 shows how 
to store data in this way. The $cart_out 
string is created by the & maintain_state 
subroutine and contains the contents of 
the shopping cart as colon-delimited 
fields consisting of the part number and 
the quantity. When the script is called, 
it reads any data passed in the cartdata 
field. To pass the data between pages, 
we use a hypertext link generated for 
each catalog entry containing the cata¬ 
log data. Both methods are necessary on 
this particular page because the script 
may be called by clicking either the cat¬ 
alog hypertext links or one of the sub¬ 
mit buttons on the form. While either 
method could have been used alone, we 
preferred GUI buttons rendered by the 
HTML form routines rather than text or 
graphic hyperlinks. This routine also re¬ 
veals a little trick for automatically sub¬ 
mitting the form when one of several 
buttons is clicked. Multiple buttons of 
type=SUBMIT are created with name-'ac¬ 
tion To find out which button was 
pressed, we simply read the value field 
of the button in our script. 

The advantages of the hidden-field 
method are ease of implementation and 
minimal server requirements. Only the 
static product databases and the single 
CGI script need to be stored on the serv¬ 
er. While easy to implement, this method 
has some problems. The back and for¬ 
ward buttons on most browsers will re¬ 
trieve a cached page, but will not rein¬ 
voke the script. For example, if a user 
adds an item to the shopping cart and 
then returns to the main catalog page 
using the browser’s back button, the 
newly added item will be lost because 
the previous page did not include the 
new data and the form was not sub¬ 
mitted to pass the data back to the 
script. Additionally, if users jump to an 
external page and then return via a hy¬ 
pertext link or bookmark, all their data 
will be lost because the state informa¬ 
tion is stored in the form, not in the URL. 
Therefore, this method is most suitable 
for simple applications or for passing 
short-term data between pages. 

Gimme Cookie! 

Netscape has implemented an elegant 
method of passing and storing state in¬ 
formation called HTTP “cookies.” The of¬ 
ficial cookie spec (see “Persistent Client 
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SciTech MGL 2.0 

Professional Graphics Libraries 

for DOS and Windows 3.1/95/NT 


Featuring: 

• Highly optimized 32-bit 
assembler 

• Color depths from 8 to 
32-bits per pixel 

• Resolutions from 320x200 
to 1600x1200 

• Automatic detection and 
utilization of VGA, VESA 
VBE 1.2/2.0 or VESA 
accelerator (VBE/AF) 
drivers 

• Full screen graphics under 
Windows 3.1/95 using 
WinDirect 

• Supports all standard C/C++ 
compilers 

• DOS or Windows 3.1/95/NT 
versions 

• DirectX and Delphi 
32 support 
coming soon 


The 32-bit MGL graphics 
library allows you direct access 
to any drawing surface so you 
can mix and match the MGL’s 
graphics routines with any of 
your own drawing or rendering 
code to come up with a high 
performance application in the 
shortest time. MGL primitives 
work identically whether you 
are rendering directly into 
VRAM or into a system buffer. 
Your MGL code is fully 
portable between DOS and 
Windows 3.1/95/NT versions 
(other OSs coming). 

2D drawing capabilities: lines, 
rectangles, circles, ellipses, poly¬ 
gons, triangles, quads, vector fonts, 
bitmap fonts, bitmaps, transparent 
bitmaps, arbitrary regions and 
mouse cursor support. 

3D drawing capabilities: lines, 
triangles and quads with flat 
shading, gouraud shading, 16/32 bit 
zbuffering and 8 bit RGB dithering. 



To order or to locate a reseller call: 

800 - 486-4823 

Download a fully functional evaluation version from: 

www.scitechsoft.com 

SciTech 

SOFTWARE I Ih 
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CIRCLE NO. 284 ON READER SERVICE CARD 


(continued from page 66) 

State HTTP Cookies,” Preliminary Speci¬ 
fication, Netscape Communications Cor¬ 
poration, 1996) describes it as follows: 

Cookies are a general mechanism which serv¬ 
er side connections (such as CGI scripts) can 
use to both store and retrieve information on 
the client side of the connection. The addi¬ 
tion of a simple, persistent, client-side state 
significantly extends the capabilities of Web- 
based client/sewer applications. 

This method has been adopted by the 
Internet Engineering Task Force (IETF) as 
a draft specification for maintaining HTTP 
state information. Cookies work by pass¬ 
ing data in the HTTP request and response 
headers. The client stores cookies in a spe¬ 
cial file and sends them to the server with 
HTTP requests that match certain criteria. 
Netscape Navigator, Microsoft Internet Ex¬ 
plorer, Netcom Netcruiser, and several oth¬ 
er web browsers currently support cook¬ 
ies. (For more information, see http:// 
www.research.digital.com/nsl/formtest/ 
stats- by-test/NetscapeCookie.html.) Ex¬ 
ample 2 is a typical cookie dialog. 

Thus, CGI scripts can generate the cook¬ 
ies and embed them into the HTTP head¬ 
er. When the browser requests a page 
from the CGI URL, the browser passes 
along any cookies it previously received 
from that server. These are stored in the 
environment variable $HTTP_COOKIE and 
can be read by the script just like other 
CGI parameters passed by the Web serv¬ 
er. Listing Two shows the modifications 
necessary to our shopping-cart system to 
use cookies to store and pass the cart 
data. You should substitute the routines 
in Listing Two for their equivalents in List¬ 
ing One. Also delete the line <INPUT- 
NAME= "cartdata" TYPE^"HIDDEN" VAL- 
UE="$cart_out"> from the show_cart, 
show_item_page, show_cart , and check_ 
out routines. 

Cookies overcome nearly all the short¬ 
comings of the hidden-form field method 
and are just as easy to implement. They 
provide superior security because cook¬ 
ies are only sent to URLs matching the 
cookie’s criteria. This reduces the chances 
of spoofing and inadvertent transmission 
of sensitive data. Users do not normally 
see the cookies, and listing the source of 
an HTML form will not reveal their con¬ 
tents. Persistence is improved over the 
hidden-field method since the cookies are 
stored in a file on die client machine. They 
will survive any amount of Web surfing 
and even shutting down the client. The 
expiration-date parameter provides fine- 
grain control over how long the cookie is 
valid and provides automatic deletion 
when it expires. This can significantly re¬ 
duce the effort required to track and ex¬ 
pire old data, which is often needed with 
a system that uses databases to store the 
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sub show.cat { 

&print_type; # the content-type: line 

&maintain_state; n this generates the state information 

print &HtmlTop("The Minishop CD-ROM Catalog"); 

print "<P>This catalog uses the type=HIDDEN form method of \n": 

print "maintaining state information between pages."; 

print "<P>Please click on an item to view more detail or to order it.\n"; 

print "<P><CENTER><TABLE B0RDER>\n"; 

print "<TR><TH>Current CDs In Stock</THX/TR>\n"; 

# sort for display 

foreach $item (sort keys(/catalog)) C 

($name, $price, $num_cd, $wt) = split ( ':',$catalog($item)); 
print qq(<TRXTD>); 
print qq(<A 

HREF="$self?action=showitem&page=$item&cartdata=$cart_out">); 

print "$name</AX/TDX/TR>\n"; 

) 

print "</TABLE></CENTER>\n"; 

print qq(<PXCENTER><FORM ACTION="$self" METHOD="POST">); 
print qq(<INPUT NAME="action" TYPE="SUBMIT" 

VALUE="Show Cart" ALIGN=left>\n); 
print qq(<INPUT NAME="action" TYPE="SUBMIT" 

VALUE="Empty Cart" ALIGN=center>\n); 
print qq(<INPUT NAME="action" TYPE="SUBMIT" 

VALUE="Check Out" ALIGN=right>\n); 
print qq«INPUT NAME="cartdata" TYPE= "HIDDEN" VALUE="$cart_out">); 

# print &PrintVariables(/form); n######## debugging 
print "</FORMX/CENTERX/BODYX/HTML>\n"; 

) 


Example 1: Storing data. 


(a) 

Content-Type: text/html 

Set-Cookie: CUSTOMER=DR_DOBBS; expires=Wednesday. 09-Nov-99 23:12:40 GMT 
>blank line to indicate end of header< 

<HTML> 

(b) 

Cookie: CUSTOMER=DR_DOBBS; ...more cookies... 


Example 2: Typical cookie dialog, (a) What the sewer sends; (b) whenever the 
client requests a URL from this sewer, it sends in the HTTP request. 


# utility arrays for dates 

@week = ('Sunday', 'Monday', 'Tuesday', 'Wednesday', 

'Thursday', 'Friday', 'Saturday'); 

@mon = (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec); 


state. A minor shortcoming of cookies is 
the limited amount of data they can con¬ 
tain: specified as 300 total cookies, 20 
cookies per domain, and 4 KB total per 
cookie (name+data). A more serious short¬ 
coming is the limited set of browsers that 
support the specification. Although the 
proportion of users with a supporting 
browser is over 80 percent, shopping-cart 
systems that must support all browsers 
will have to use a different method until 
the specification is more universally sup¬ 
ported. 

Databases: Tried and True 

When considering how to store state in¬ 
formation for a shopping cart or other ap¬ 
plication, some kind of database is what 
first comes to mind. As we’ve discussed, 
HTTP does not provide the continuous 
connection most developers are used to. 
Simply using a database to store the state 
information is not enough. We still need 
to be able to link the HTTP request with 
the data stored in the database. Example 
3 and Listing Three show the modifica¬ 
tions needed to run our system using a 
database to store the state. To modify 
Minishop2.cgi to use a DBM database, 
add Example 3 near the top of the file, 
then substitute the routines in Listing 
Three for their equivalents. This version 
of Minishop is a hybrid, using a cookie 
to store a unique Userid identifier as a 
key to access the data stored in the 
database. We use standard DBM files be¬ 
cause of their simple setup, and Perl’s 
built-in support. Perl accesses DBM files 
as an associative array, providing a very 
simple interface to the database. We have 
two such databases in Minishop. %id_hase 
holds the information for generating the 
next Userid cookie. In our case, this is a 
simple integer that increments for each 
new user. In a more complex system, we 
could use more-complicated methods of 
generating user ids and store more data 
about the user (perhaps in encrypted 
form). The %cart_db database holds the 
actual shopping-cart contents in the same 
colon-delimited form we used for the 
form data and the cookie data. 

With a bit of extra work to pass the data 
needed to identify the user, database- 
management systems can be used very ef¬ 
fectively to store data in Web applications. 
The disadvantage is the sometimes con¬ 
siderable overhead and server load of a 
database system, which may be overkill 
for a simple application. 

Advanced Topics 

A number of additional issues should be 
considered when implementing an online 
shopping system. Security is always a con¬ 
cern, and the architecture of your system 
should be designed with security in mind. 


Example 3: Modifying Minishop2.cgi. 

The browser-to-server transactions can be 
encrypted with the Secure Socket Layer 
(SSL) system used by Netscape servers and 
others. Data stored on the server should 
be encrypted using systems such as PGP, 
and orders transmitted via e-mail or FTP 
should also be encrypted. The Web is de¬ 
signed to be open and accessible to all, 
so locations of files, permissions, and the 
data stored or transmitted across the Web 
should be carefully considered. 

After several years of anticipation, meth¬ 
ods of conducting secure financial transac¬ 
tions are starting to emerge. Online valida¬ 
tion of credit-card charges, digital cash, and 
automatic-checking debits are a reality. 

Web sales systems should be integrated 


with existing methods (such as telephone 
and mail-ordering) to link with sales, in¬ 
ventory management, and manufacturing 
systems. 

Emerging technologies, such as Java, may 
supersede much of the functionality dis¬ 
cussed in tills article. However, at this point, 
only a single commercial browser supports 
Java. The current need for reliable, plat¬ 
form-independent, client-server applica¬ 
tions demands the use of universally sup¬ 
ported protocols such as HTTP and CGI. 


DDJ 

(Listings begin on page 83.) 
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EXAMINING ROOM 



Examining the 
InstallShield SDK Edition 

Don't underestimate the 
installation process 

Joseph Hlavaty 


D iligent programmers spend hours or 
days manipulating user interfaces to 
get them exactly right. After all, if 
the UI doesn’t look professional or 
is hard to manipulate, users will find an¬ 
other application with similar functional¬ 
ity. Still, a user’s first impression of your 
application comes with the installation pro¬ 
cess, not the UI. 

Unfortunately, even commercial appli¬ 
cations often have insufficient or unusable 
installation routines. We’ve all seen com¬ 
mercial Windows applications that use DOS 
batch-file installs (or no install at all), leav¬ 
ing it up to users to copy one or more 
diskettes to a hard drive, install program 
icons, and so forth—all from a command 
prompt. Clearly, a standardized installation 
process is an asset to any application. In 
this article, I’ll present such a process that 
uses InstallShield SDK Edition (SE), an in¬ 
tegrated installation/distribution program 
included with Microsoft Visual C++ 4.1. 

InstallShield SE, which is located in die 
ISHIELD directory of Visual C++ 4.1 or 
MSDN 2 Win32 SDK CD-ROM, is a cus¬ 
tomized subset of the standalone Install- 
Shield3- VC++ 4.1 also includes Install¬ 
Shield Express, a customized 32-bit 
visual-installation system that’s a subset 
of InstallShield Express Professional (also 
a stand-alone tool). Customized versions 
of InstallShield Express are also shipped 
with Visual Basic 4.1, Borland’s C++ 5.0, 
Delphi 2.0, Paradox 7.0, and Powersoft’s 
Optima++. 

While I’ll use VC++ and the version of 
InstallShield SE shipped on the January 
1996 MSDN 2/3 Win32 SDK CD-ROM, die 
methodology I describe can be imple¬ 
mented with virtually any development en- 


Joe works for IBM Software Solutions in Re¬ 
search Triangle Park, NC, although he cur¬ 
rently lives in Warsaw\ Poland. He can be 
contacted at JHlavaty@vnet.ihm.com or 
102344 , 2244@compuserve.com. 


vironment and installation/distribudon sys¬ 
tem. For the purpose of illustrauon, I’ll dis¬ 
cuss the design and creation of die instal¬ 
lation scripts and diskette for a tool called 
“WinDebug32,” which uses Win32 debug 
APIs to debug Windows applications. 
WinDebug32 (available electronically; see 
“Availability,” page 3) ships with a readme 
file and sample app named “DeadMan32.” 
(WinDebug32 itself will be discussed in a 
future DDJ article.) This installation script 
(also available electronically) was devel¬ 
oped under Windows NT 3.51, although 
I’ve done some testing under Windows 95. 

The Registry 

The Registry is a collection of keys and val¬ 
ues stored in a Win32 hierarchical database. 
Many of the values stored in the Registry, 
such as application padis, application state 
information such as user preferences, and 
so forth previously would have been stored 
in an .INI file or one of the DOS configu¬ 
ration files (config.sys or autoexec.bat) un¬ 
der 16-bit Windows. The Registry Is viewed 
and accessed as a single database. The 
number, names, and locations of registry 
files may differ depending on your version 
of Windows. These registry files are not ed¬ 
itable directly; you need a Registry editor 
(such as REGEDT32.EXE). Be sure to make 
backup copies before attempting to edit 
them (corrupting these files can make your 
Windows system unbootable). Since Reg¬ 
istry infonnation is extremely important for 
installation and deinstallation using In¬ 
stallShield, I’ll describe the basic setup and 
use of the Registry. 

The key hierarchy in the Registry forms 
a path (from a root key to a subkey) that 
allows access to information stored in the 
Registry. Unlike in the file-system hierar¬ 
chy, the Registry key hierarchy contains 
six default keys that can be viewed as ap¬ 
plication entry points into the Registry. 

Each key in the Registry has a name 
and a default value. Other name/value 


combinations can also be added. My copy 
of VC++, for example, installs lists of most 
recently used files and projects in the reg¬ 
istry under HKEY_CURRFNT_USER\Soft- 
ware\MicrosoJl\Developer\Recent File List\. 

Filel:REG_SZ: C:\MSDEV\PROJECTS\ 
MYPROJ\MYPROJ.CPP FileCount:REG_ 
D WORD: 0x02. HKEY_CURRENT_USER is 
the root key through which you access 
this information. Software , Microsoft , De¬ 
veloper ; and Recent File List are subkeys. 
I’ve listed two of the value entries for the 
aforementioned key here: the value name 
Filel , which is of data type string and con¬ 
tains die value c:\msdev\projects\myproj\ 
myproj.cpp; and die value name FileCount, 
which is of type divord and contains the 
numeric value 2. The information found 
in the HKEY_CURRENT_USER section of 
die Registry always takes precedence over 
that found in HKEY_LOCAL_MACHINE. 

Microsoft recommends diat applications 
store generic information under the 
HKEY_LOCAL_MACHINE. Information 
specific to a user (such as die Recent File 
List) should be stored under HKEY_CUR- 
RENTJJSER (which is actually a subset of 
HKEYJJSERS). In eidier case, information 
should be stored under the subkey path 
\software\COMPANYNAME\ PRODUCT- 
NAME\RELEASE. 

HKEY_CLASSES_ROOT is the root key 
used to store application icon information, 
application file extensions, icon commands 
(pop-up menu commands), and so forth. 
This key points to HKEY_LOCAL_MA- 
CHINE\Software\Classes. 

HKEY_CURRENT_CONFIG and HKEY_ 
DYN_DATA root keys are used to access 
hardware-specific information and point 
to subsets of die HKEY_LOCAL_MACHINE 
root key. HKEY_CURRENT_CONFIG 
points to HKEY_LOCAL_MACLIINE\ CON¬ 
FIG. H KEY_DYN_DATA is cached while 
Windows is actually running to permit ex¬ 
tremely fast access to hardware state in¬ 
formation. 
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(continued from page 70) 

Win32 applications should use the Reg¬ 
istry for storing information. Microsoft 
states that .INI files should only be used 
if application state data in the Registry 
would exceed 1000 bytes. 

Designing the Installation Process 

Before writing your first installation script, 
you need to identify what files to install, 
where to install them, and how your in¬ 
stall will differ from the standard install. 
Once you’ve written the installation script, 
you’ll build images of the installation disks 
and test your installation. This process is 
iterative. When you are satisfied that the 
installation process is working as required, 
your last set of installation disks become 
the “Golden Master” diskettes for a given 
release. 

The files you install might include 
those from your build process (help files 
and executables), text files (such as a 
readme file), executables (a tutorial pro¬ 
gram, compiler libraries or other redis- 
tributables), image or graphic files 
(bitmaps or document files saved in non¬ 
text formats), or other specialized files. 
In the WinDebug32 scenario, you’ll need 
to install three files— a readme file from 
the build directory and two executables 
(windebug32.exe and deadman32.exe) 
from the build\exe directory. At this 
stage, you do not include files that you’ll 
ship that are not part of the application, 
such as setup.exe. 

Next, you must decide where each file 
from your first stage will be installed in 
your application subdirectory on the tar¬ 
get machine. For example, you might have 
program files in the application subdirec¬ 
tory itself. If you share DLLs between a 
number of apps, you might place them in 
a directory common to all apps, not in ev¬ 
ery individual application directory. This 
means that installations after the first app 
take up less space (as multiple copies of 
the shared libraries aren’t installed). A com¬ 
mon directory also permits you to upgrade 
common code for multiple applications 
with a single product installation. 

If the software includes samples, you 
might place them in a subdirectory off of 
your application directory. If your appli¬ 
cation includes online documentation, you 
might include that in a separate subdi¬ 
rectory. If you ship both retail and debug 
versions (for developers), you might place 
each in its own directory. Careful use of 
a subdirectory structure helps users find 
their way around your installed applica¬ 
tion files. Create too many subdirectories, 
however, and you’ve complicated things. 
Also remember not to install your appli¬ 
cation files to the root (or top-level) di¬ 
rectory due to limitations in the number 
of files that can be placed here. 


Keep in mind that certain pieces of your 
app may need to be installed in a particu¬ 
lar directory for reasons unrelated to the 
application itself. For example, library files 
should be installed so that they are acces¬ 
sible to Windows during program execu¬ 
tion. Refer to the Win32 SDK documenta¬ 
tion for information on where Windows 
will look for these types of files. For small 
applications, installing everything to a sin¬ 
gle directory is probably an acceptable so¬ 
lution. In the WinDebug32 scenario, I’ll 
place all files in a single subdirectory on 
the user machine during installation. 

In the next stage of the installation pro¬ 
cess, decide what installation options users 
should have. A standard install might in¬ 
clude a typical install for nontechnical 
users. This installs all pieces of the appli¬ 
cation needed by most users. This guar¬ 
antees a working system (barring instal¬ 
lation failure of some kind). 

Compact installs are for users with lit¬ 
tle room on the installation machine. Lap¬ 
tops, with small hard drives and little space 
for apps, often require this type of instal¬ 
lation. As before, users do not need to se¬ 
lect which pieces of the application should 
be installed, and (barring installation fail¬ 
ure) are guaranteed a working system. 

Custom installs are for advanced users. 
Depending on the installation options you 
permit users to choose and which options 
the user selects, the installation may not 
result in a working system. You should give 
users as many options as possible, group¬ 
ing related files into a single check box. If 
sample files are included, for example, you 
might install all of them if the sample check 
box is checked, and none if it is not. 

Remember to let users know which files 
are required for a working system. They 
may elect not to install them at their own 
risk. For example, they may elect not to 
install shared library files if they know that 
these files are already installed on their 
system by another app in the product 
suite. At this stage of die installation pro¬ 
cess, consider which (if any) parts of your 
application can be considered optional 
and if there are any prerequisites to in¬ 
stallation (required operating systems, 
video drivers, and so forth) that users will 
need to check for. 

In the WinDebug32 scenario, I use all 
three installation scenarios. A typical install 
includes the readme, windebug32.exe, and 
tester application. A compact install includes 
only the readme and windebug32.exe. A 
custom install lets users choose winde- 
bug32.exe with readme (the program se¬ 
lection) and/or the debugging tool. 

In the fourth stage of the installation 
process, you design installation UI ob¬ 
jects—the dialogs and message boxes pre¬ 
sented to users during installation. If your 
app requires Windows NT (perhaps your 


application uses OpenGL, for example, 
which is not currendy supported under 
the current release of Windows 95 or 
Win32s), you need to design a dialog in¬ 
forming users of the operating system in¬ 
compatibility if they attempt to install your 
software on Windows 95 or Win32s. 

These dialogs and message boxes 
should be rough drafts. You use them to 
select similar dialog boxes from the sup¬ 
port within InstallShield SE. Only a lim¬ 
ited number of dialogs are available in 
InstallShield SE, and user-defined dia¬ 
log routines are not permitted; the Mes- 
sageBoxO routine documents only IN¬ 
FORMATION, SEVERE, and WARNING 
styles, but SDK styles may also be used. 

Even in the SDK version, the InstallShield 
dialog routines included are powerful: 

• AskDestPatbO can display a dialog box 
that asks users to select a path, which 
could be used to set the destination path 
of your app. 

• AskOptionsO can display a dialog box 
containing radio buttons or check boxes 
that users can select from. A dialog with 
check boxes can implement the custom- 
installation option described earlier. 

• AskTextO can display a dialog that re¬ 
quests a single line of text from users. 
This dialog might be used to request 
users to enter their name or company’s 
name during installation. 

• AskYesNoO can display a dialog that 
asks a single yes/no question. For ex¬ 
ample, if users cancel installation before 
completion, this function can confirm 
that they want to exit the install process. 

• MessageBoxO can display a modal di¬ 
alog box (one that requires immediate 
user interaction). This routine only sup¬ 
ports message boxes of type MB_OK, 
unlike the SDK function of the same 
name. You might use this function to 
warn users that installation was unsuc¬ 
cessful due to an error. 

• SelectFolderO can display a dialog re¬ 
questing that users choose a folder (pro¬ 
gram group under WinNT 3.x), either 
by selecting a preexisting folder or cre¬ 
ating a new one. You might use this 
function to select the folder in which 
application icons should be created. 

• SetDialogTitleO changes the default ti¬ 
de for dialogs of a given type. It should 
be called before requesting the dialog 
function whose default tide you wish to 
change. This function call affects all fu¬ 
ture function calls of this type during 
the current installation. 

• SetupTypeO creates the setup options 
dialog (containing Typical, Compact, 
and Custom selections). 

• WelcomeO creates a standard splash 
screen/welcome dialog at the beginning 
of installation. 
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The \VinDebug32 scenario uses a vari¬ 
ety of these functions to create its UI. 

At the filth stage of the installation pro¬ 
cess, you develop your setup script’s flow 
of execution using InstallScript, the In- 
stallShield programming language. (Install 
scripts are simple text files that commonly 
have an .RUL extension. InstallScript is a 
Basic-like, case-sensitive language. A ba¬ 
sic description of InstallScript is available 
electronically.) Your script should also set 
registry variables relative to your installed 
software. To properly set up application- 
registry variables using InstallShield, you 
must call both the InstallationlnfoC’) and 
the DeinstallStar1() APIs before manipu¬ 
lating the Registry. 

Win32 applications should store pro¬ 
gram variables only in the Registry; Win¬ 
dows .INI files and functions should not 
be used. You can view the contents of 
your Registry using the REGEDT32 pro¬ 
gram that comes with WinNT. The main 
installation script of an application script 
normally is called “setup.rul.” 

The following pseudocode is a brief de¬ 
scription of the install script used in the 
WinDebug32 scenario. The prefix User: 
indicates a section of the script that re¬ 
quires user response. 

1. Initialize global variables. 

2. Initialize InstallShield (via Installing)). 

3. User: Display welcome window. 

4. Check user hardware. 

5. User: Ask where to install to. 

6. User. Get type of install (typical, com¬ 
pact, or custom). 

7. Check user available space. 

8. User: Ask what folder or group to cre¬ 
ate for the program. 

9. Initialize InstallShield undelete pro¬ 
cessing (via DeinstallStartO). 

10. Set basic Registry keys and values. 

11. Define file set for file transfer to user 
system. 

12. Execute file set. 

13. Final registry updates. 

14. Update shell (create program group). 

15. User: Tell user that the install is done. 

The pseudocode is not entirely accu¬ 
rate because die installation process is not 
always sequential. Users may move back¬ 
ward to previously seen dialogs or abort 
the installation process entirely, which is 
not shown in the pseudocode. 

At die sixth stage of the installation pro¬ 
cess, you create the installation diskettes 
for installing die software for testing. To 
begin, you’ll need to create the subdirec¬ 
tory structure from which you’ll build your 
product. For this discussion, assume that 
the files are stored under a top-level \in¬ 
stall subdirectory. In the WinDebug32 sce¬ 
nario, I use die subdirectories build, tools, 
diskl, disk2, and setup. 




Right now nearly 800,000 users are getting a great view thanks 
to ViewDirector™ from TMSSequoia. If your solution calls for 
image enabling, ViewDirector adds sophisticated imaging capa¬ 
bilities to new or existing applications. And it provides really 
fast, all-software compression and decompression (especially for 
bitonal images). Display and convert multi-page TIFF G3/4, 
JPEG, GIF, DWG, DXF and other industry standard formats. 
Get a view of these features: 


• Zoom, rotate, pan 

• Bitonal, color and vector 
support 

• Scalc-to-gray 

• Print acceleration 

• Image overlay 


• Large image management 

• Hyperlinking 

• Image caching and tiling 

• Image annotations, redlining 
•Two magnifying glasses and 

bird s eye view 


ViewDirector is available as C Libraries, a VBX, an OCX or 
Class Libraries for INFORMIX-NewEra™ Plus, we offer the 
ViewDirector Pro Imaging Plug-In for Netscape Navigator. 
(You can download and test drive these products from our cool 
web site at www.tmsinc.com.) What are you waiting for? Get a 
great view today! 


% I Mm Sequoia 


Phone: 1-888-677-TMSS (North America 6c International) 
Fax: 405-377-0452 • Internet: www.tmsinc.com 


CIRCLE NO. 293 ON READER SERVICE CARD 


Dr. Dobb’sJournal, September 1996 


73 



















INDEXES OF 


Dr. Dobb’s 
Journal 

1982 - 1995 


■ Cumulative Subject and 
Author Indexes for the years 
1982 through 1995, bound 
in one volume. 

■ An 8"xl 1" paperback with 
181 pages and 12,100 
entries. 

■ Detailed coverage of all 
editorial material, including 
reviews, interviews, letters, 
tables, bug reports, sidebars, 
and more. 

■ Find that article, program, 
product review, algorithm, 
or routine (by language or 
type) in seconds, or follow 
the threads of a technical 
conversation. 

■ The book version is $23.95 
(Canada $25.50 U.S.). 

■ Hypertext version (updated 
quarterly) available on a 3.5" 
disk (DOS); $14.95 ppd. 
(Canada $15.70 U.S.). 

Updates are $10.00 (Canada 
$11.00U.S.). 

■ Annual subscription is avail¬ 
able (4 disks) $26.00. 

■ Visa and MasterCard 
accepted. 

To Order Call: 

804-977-7015 or 
800-678-2848 

or e-mail: sbach@well.com 

Stephen Bach 

1208 Meriwether Street 

Charlottesville, VA 22902-5421 

For shipping paperback edition via first-class mail add $5.00 
(Canada $6.00 U.S.). 


CIRCLE NO. 223 ON READER SERVICE CARD 


build. This directory is where applica¬ 
tion files are copied: The readme file is 
in the build directory itself, and the pro¬ 
gram files are in the .exe subdirectory 
directly beneath it. This subdirectory 
structure is a convenience during instal¬ 
lation-disk creation and has no rela¬ 
tionship to the directory structure you’ll 
use during installation. 

setup. This directory is where you 
maintain the application setup scripts 
and other installation data files. It in¬ 
cludes setup.rul (the source for our in¬ 
stallation script) and setup.lst (the source 
for our setup package file). The object 
files setup.ins (the compiled form of set¬ 
up.rul) and setup.pkg (the compiled form 
of setup.lst) will also be built in this di¬ 
rectory. 

The package file is used to tell Install- 
Shield which installation disk contains a 
particular file needed during installation. 
This file is required if your installation 
script uses file sets. 

tools. This directory contains those In- 
stallShield binaries for building and in¬ 
stalling the app. Some files will be copied 
to disk by an installation disk, and some 
are used only to build installation object 
(binary) files. My directory contains: 


compile.exe 

// build only 

icomp.exe 

// build only 

packHst.exe 

// build only 

setup.exe 

// install only 

_setup.lib 

// install only 

_setup.dll 

// •install only 

split.exe 

// build only 

uninst.exe 

// install only 

These files 

are InstallShield SE exe- 


cutables, so they are not available online. 
Copy them from the InstallShield binaries 
directory (normaUy\ishield\program) into 
your TOOLS directory before building. 

The Compressed File 

In the WinDebug32 scenario, I use a sin¬ 
gle compressed file, windeb32.z, to store 
all application files. This file is created 
by the ICOMP command, which com¬ 
presses, uncompresses, and examines 
compressed files. I compress all files in 
the build directory and all subdirecto¬ 
ries into the \install\windeb32.z file with 
the command ICOMP - i build\*.* win- 
deb32.z 

Splitting the Compress File 

The InstallShield binaries used during in¬ 
stall (setup.exe, _setup.dll, _setup.lib, and 
uninstexe) are about 700 KB in size. Since 
all of these files need to be found on diskl, 
only about 700 KB are left on a 1.44-MB 
diskette. While the WinDebug32.z com¬ 
pressed file is small enough to fit on this 
disk too, you might need to use the split 


tool to split your compressed file into 
diskette-sized pieces. Assuming that you 
had only 700 KB of free space on diskl 
and want to install from 1.44-MB diskettes, 
you would use the command split.exe 
-J1370- dl@700 YourCompressedFile.z: 
This creates YourCompressedFile. 1 ... Your - 
CompressedFile.n data files, where n is 
the total number of diskettes needed for 
that particular compressed file. (Your in¬ 
stallation may or may not have more than 
one compressed file, so these numbers 
may or may not translate to the number 
of the installation diskettes that will con¬ 
tain them.) 



The package file contains a list of all the 
non-InstallShield files used during instal¬ 
lation and tells InstallShield on which in¬ 
stallation diskette they will be found. In 
the WinDebug32 scenario, the install di¬ 
rectory (the parent directory of SETUP) 
contains the main compression file 
(windeb32.z), so the source package file 
in the setup directory contains the lines: 

1 ; 

.Awindebug32.z 

2 ; 

..\windebug32.z 

This package file states that diskl will 
contain files from the windeb32.z com¬ 
pression file, and disk2 will contain files 
from the same compression file. You give 
a relative path to the compression file, 
which is in the parent directory of the di¬ 
rectory containing the setup.lst file. (This 
source package file assumes that Win- 
Deb32.z is oversized for our installation 
media and was split into two files.) A pack¬ 
age file always contains the original (un¬ 
split) version of the compressed file name. 

If your installation contains more than 
one diskette, each diskette must contain 
a disk A", id file, where iVis the sequential 
number of the installation diskette. Each 
id file should be copied to the given disk/V 
directory under the install directory. The 
id files shipped with the InstallShield sam¬ 
ple app contain three bytes— a carriage 
return/line feed, and EOF character. These 
files are used during file-set processing 
to identify the diskette actually inserted 
by users. 

Creating Diskette Images 

After using ICOMP.EXE to create your 
compressed file(s), COMPILE.EXE to cre¬ 
ate your setup.ins file, and PACKUST.EXE 
to create your setup.pkg file, you’ll copy 
the output of these commands to the ap¬ 
propriate diskette subdirectories. In the 
WinDebug32 scenario, all of these files 
are copied to the diskl directory, which 
contains the following: 
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(continued from page 74) 
setup.exe 
_setiip.dll 
_setup.lib 
uninst.exe 
windeb32.z 
setup.ins 
setup.pkg 

You can modify the included build.cmd 
file, which automates much of the 
installation-disk creation process. This is 
a Windows NT batch file (change the 
name to build.bat under Win95). Finally, 
copy each of the diskiV directories to for¬ 
matted disks of the appropriate type. In 
the WinDebug32 scenario, each directo¬ 
ry should be copied to formatted, empty 
1.44-MB diskettes. 

Test Your Installation Script 

To test your application installation, run 
setup.exe from the diskl directory you 
created, which may be on a CD-ROM or 
hard disk. In the WinDebug32 scenario, 
however, this file is found on the flop¬ 
py disk built for the product. You should 
be testing your application installation 
on every individual platform your ap¬ 
plication supports. If using Windows 95, 
remember to test both installation from 
diskette and from Add/Remove Programs 
in the Control Panel; also test deinstal¬ 
lation from your group/folder and from 
Add/Remove Programs in the Control 
Panel. 

It is important to test all paths of exe¬ 
cution available for users, including all 
possible custom paths. Remember to test 
all return (“Back”) and cancel options, 
also. You’ll find the UI rough drafts and 
pseudocode helpful at this stage. 

If your install tests perfectly and your 
app has passed all necessary tests for re¬ 
lease, then your test diskettes become 
the Golden Master diskettes, and you 
can begin to ship this release. Congrat¬ 
ulations! 

If your install tests perfectly, but your 
app still needs work before release, then 
you will need to continue to test your in¬ 
stallation while making application 
changes. Remember, you'll also need to 
potentially rework (and retest) your in¬ 
stallation if application file sizes change 
(you may need to move files to another 
disk or split the first disk differently), or 
if the files in your installation change 


(new files are added to your build tree 
or existing files are removed). 

If your install doesn’t test properly, 
you’ll need to reiterate the installation 
process to correct the deficiencies, then 
retest. 

Debugging InstallShield Scripts 

InstailShield SE does not include an inte¬ 
grated debugger. You can use the #if and 
#ifdef directives to build debug and retail 
versions of your scripts, however. 

Compile your rule file using the -D op¬ 
tion to define a variable DEBUG, for ex¬ 
ample, then use #if or #ifdef to test for 
your definition in your InstallScript pro¬ 
cedure; see Example 1. You can also use 
WriteLine() to write strings to a log file. 
A useful technique for debugging file-set 
problems during installation is to use the 
ICOMP command with the -1 option to 
view the names of files stored in a com¬ 
pressed file. 

Uninstalling Your Application 

If your application uses shared DLLs, keep 
a count of how many applications are us¬ 
ing these DLLs in the Registiy, or suggest 
to users that they might need to be delet¬ 
ed if uninstalling. 

Your application should place the fol¬ 
lowing value entries in HKEY_LOCAL_ 
MACHINE\Software\Microsoft\Win- 
dows\CurrentVersion\Uninstall\APP- 
NAME.EXE, (where appname.exe is the 
name of your application’s main exe¬ 
cutable): 

• DisplayName, a string that is displayed 
to users in the Add/Remove Programs 
property sheet of the Control Panel. 

• UninstallStnng, a string containing a ful¬ 
ly qualified path to the deinstallation 
utility, including all parameters neces¬ 
sary for it to deinstall your app. 

This will be done by the InstallShield 
DeinstallStartO API. InstallShield also 
copies the uninst.exe file off your diskette 
to the Windows directory on the installa¬ 
tion machine. Don’t forget to create the 
icon (in your folder or group) that per¬ 
mits the user to deinstall your app. 

Other Versions of Win32 Setup 
Software 

Previous releases of VC++ have includ¬ 
ed setup software that is incompatible 


with what I’ve just described. However, 
the software-installation design process 
that I’ve discussed here may still be used. 
If you wish to use another setup tool, 
simply substitute the relevant commands 
(such as the disk layout tools) as out¬ 
lined in your documentation. I strongly 
recommend upgrading your installation 
software to InstallShield if you are still 
using the earlier setup tool that shipped 
with previous versions of VC++. 

When to Develop Your Installation 
Process 

It is not necessary to develop your instal¬ 
lation process early on in your develop¬ 
ment cycle. You should not, however, wait 
too long to begin thinking about installa¬ 
tion. At the absolute latest, you should 
have a working installation process and 
setup script before your software begins 
beta testing. 

Why? Because, even though tools like 
InstallShield SE remove much of the com¬ 
plexity of product installation, tilings can 
still go wrong. A frequent source of prob¬ 
lems are outside of the install script. For 
example, you might be copying files from 
the wrong section of your build tree dur¬ 
ing diskette creation, or failing to copy an 
optional file that isn’t normally installed. 
These are easy problems to miss if you’re 
creating installation routines at the last 
minute. 

Final Comments 

However well developed and well test¬ 
ed your installation process, there is al¬ 
ways the possibility of error. Perhaps 
your installation media are faulty, or 
maybe there are problems with your in¬ 
stallation on a particular type of hard¬ 
ware. It’s a good idea to ship your 
readme file as a plain-text file, uncom¬ 
pressed and on your first disk, and 
supply at least minimal printed docu¬ 
mentation describing the basic installa¬ 
tion process and giving basic customer- 
support information (phone number or 
e-mail address). This will let users get 
help even if they can’t uncompress your 
installation files or read the diskette. Re¬ 
member, if they can’t install your soft¬ 
ware, they can’t use it! 


For More Information 

InstallShield Corp. 

1100 Woodfield Road, Suite 108 
Schaumburg, IL 60713 
847-240-9111 

http://www.installshield.com 


nif DEBUG=1 // compile with -DDEBUG=1 to include. 

// -DDEBUG=0 or not defined at all to skip 
MessageBox( "Error in <some routine)" ) ; 

#endif 


Example 1: Compiling the ride file using the-D option to define a 

vaiiable DEBUG. DDJ 


76 


Dr Dobb’sJournal, September 1996 








MAINWIN STUDIO. 

THE ONLY COMPLETE MICROSOFT-BASED 
CROSS-DEVELOPMENT ENVIRONMENT 
TO BRIDGE WINDOWS APPS TO UNIX. 


DON'T FALL FOR AN 
APPROACH THAT COMES 
UP SHORT. 

Only MainWin Studio 
gives you all the pieces. 

So now it's truly possible to 
port any of your Windows 
applications to UNIX. Quickly 
ana accurately. 

All in an environment 
that's completely based on 
Microsoft source code. 

Here's how: 


©1996 Mainsoft Corporation. 1270 Oakmead Parkway, Suite 310, Sunnyvale. CA 94086. Tel: (4081 774-3400. Fax: (408) 774-3404. MainWin is a registered 
trademark and Mainsoft is a trademark of Mainsoft Corporation. All other products or services names are trademarks or registered trademarks of their respective owners. 

CIRCLE NO. 91 ON READER SERVICE CARD 


WINDOWS API. Write 
code once, then maintain a 
single base across all platforms. 

TEST. Re-use your MS 
Test scripts across all platforms. 

VERSION CONTROL. 
Accurately trace your source 
code revisions and control 
code modifications. 

HELP. Use the Windows 
Help Engine on UNIX to play 
the help files developed 
under Windows. 


RESULTS. Get apps out 
faster and get a higher return 
on investment. 

CALL NOW. And get 

a free evaluation copy of 
MainWin software. You can 
also contact us via e-mail at 
info@mainsoft.com. Visit our 
web site at http://www. 
mainsoft.com. 

MAINSOFT 

1 (800) MAINWIN 
































































































PROGRAMMER'S WORKBENCH 



Java, JFactory, and 
Network Development 

Visual development meets client/server 

Eldon Metz 


J Factory is a cross-platform screen 
painter, prototyper, and code genera¬ 
tor for Java that lets you concentrate 
on the design and functionality of your 
GUI by generating Java’s Abstract Window 
Toolkit (AWT) source code. As a devel¬ 
oper of JFactory, I’m often asked how it 
can be used to build client/server appli¬ 
cations. To answer this question, I’ll de¬ 
scribe the development of a chat applica¬ 
tion called “JChat”—an Internet-based 
client/server Java application that uses 
sockets for communication. 

The project file, source code, and Aid 
documentation for the application are 
available electronically (see “Availability,” 
page 3) or at URL http://www.roguewave 
.com by following the links to the JChat 
sample page. You may find the classes 
packaged in COM.roguewave.jchat use¬ 
ful. They are freely modifiable and dis¬ 
tributable. The javadoc-generated API doc¬ 
umentation and full source code for the 
foundation objects that comprise the client 
and server can also be found at URL 
http:// www.roguewave.com. 

JChat Specifications 

The JChat server is an asynchronous, 
multithreaded Java application. The serv¬ 
er keeps track of an unlimited number of 
connections (abstract representations of 
the socket-pair relationship between a 
client and server) and forums (any num¬ 
ber of connections on a topic of interest). 
Connection requests from clients are con¬ 
tinuously accepted. Once a successful con¬ 
nection has been established, the client 
sends the name of its user to the server. 
The server adds the connection to its col¬ 
lection of current connections, and sends 
to the client the names of all the forums 
that are currently available to join. 


Eldon, a developer for Rogue Wave Soft¬ 
ware, can be contacted at metz@rogue- 
wave.com. 


Once a connection is established, each 
client communicates with die server by send¬ 
ing commands. Each client lias a connection 
diat monitors a particular socket for incom¬ 
ing data. As soon as a complete command 
Ls received, die command is processed and 
die appropriate acdon is perfonued. 

The JChat client, on the other hand, is 
Internet based and can be executed as an 
applet running within a Java-enabled web 
browser. The asynchronous, multithread¬ 
ed JChat client consists of a GUI that al¬ 
lows users to connect to the server, join 
and contribute to existing forums, and cre¬ 
ate new forums. 

Creating the JChat Server 

The server is a stand-alone Java applica¬ 
tion that creates a Receptionist and Dis¬ 
patcher. It is started by running the Java 
interpreter on the Seiver class (diat is, java 


Sewer). It runs continuously (Ctrl-C will 
stop it). The Receptionist listens for in¬ 
coming connection requests, then hands 
them to a dispatcher, which takes care of 
processing die commands diat are received 
from each client. The Dispatcher is an ab¬ 
stract class and both die server and client 
instantiate a specialized implementation of 
it. The server implements a ForumDis- 
patcheno process commands from clients, 
which are made up of four strings. Table 
1(a) lists the commands the Forum Dis¬ 
patcher object understands. The client im¬ 
plements a FonimViewDispatcher to pro¬ 
cess commands received from die server. 
Table 1(b) lists commands understood by 
the Fonim ViewDispatcher object. 

Creating the JChat Client 

I used JFactory to design, prototype, and 
generate most of the code for the JChat 



Figure 1: JFactoiy desktop. 
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Born Curious? 


Getting at the 
guts of stuff used 

to be so much 

/ fun, 

whoever 

thought 

that one 
day you’d 

get paidl 

for it? 


I 


SM 


At Microsoft, we know that tearing things apart is an important step in putting together a superior product. So our Software 
Test Engineers, born with a natural affinity for dissecting things, are important to every one of our product milestones, from 
beginning to end. Why not work in a place where everybody thinks looking inside stuff for bugs is still cool? 


Lead Software Test Engineer 

Direct a team responsible for testing across-the-board 
features of Microsoft Works such as integration, calendaring, 
OLE and user assistance. Involves developing and imple¬ 
menting both manual and automated test specs and cases; 
managing a task list and schedule; working closely with the 
development team; and communicating back to the test 
team. Requires 1+ years Windows® applications testing expe¬ 
rience, ideally in a lead capacity. Knowledge of a structured 
programming language such as C or Visual Basic® preferred. 

Lead Software Test Engineer 

Oversee a team in the design, implementation and execution 
of test strategies for a pair of widely used internal text editing 
and layout components. Involves fostering relationships with 
multiple client test teams. Requires 1+ years experience as a 
test lead for commercially shipped Windows products, and 
sufficient programming abilities to design and implement 
automated testing suites. Knowledge of component/API testing, 
Far East testing and the Macintosh® environment desirable. 


Software Test Engineer 

Design, develop and execute test cases and suites for 
FrontPage ,M . Involves driving testing through both manual 
and automated methods using Microsoft and third-party 
automation tools. Requires 3+ years software testing 
experience on commercially shipped Windows or Macintosh 
products, and basic coding skills. Knowledge of (or the 
ability to quickly grasp) web authoring tools and Internet 
architecture essential; client/server experience desirable. 

A Bachelor’s degree In Computer Science or a related 
technical discipline preferred for all positions. 

Email your resume in ASCII text format to 
resume@microsoft.com (Indicate Dept. A28c8-0996 in the 
subject header). Or mail it to: MICROSOFT CORPORATION, 
Attn: Recruiting, Dept. A28c8-0996, One Microsoft Way, 
STE 303, Redmond, WA 98052-8303. No phone calls 
please. We are an equal opportunity employer and support 
workforce diversity. 


Microsoft 


WHERE DO YOU WANT TO GO TODAY?* 


http://www.microsoft.com/jobs/ 

Microsoft. Windows and Visual Basic are registered trademarks and FrontPage and Where Do You Wont To Go Today? ore trademarks of Microsoft Corporation. 
Macintosh is a registered trademark of Apple Computer. Inc. 




(continued from page 78) 
client. Overall, it took less than an hour 
to build the graphical part of JChat (in¬ 
cluding the time required to change or 
add to the design). Consequently, I won’t 
go into a blow-by-blow description of how 
you create the JChat client. After all, the 
process largely involves visual drag-and- 
drop and point-and-click. What I will do, 
however, is briefly discuss JFactory basics, 
then identify the fundamental steps in¬ 
volved in designing and implementing 
JChat. 

Creating a new project in JFactory is 
straightforward. A single dialog prompts 
you for the name, directory, and template 
project to begin with. The template pro¬ 
jects you can choose from are customiz¬ 
able, but JFactory ships with typical Ap¬ 
plet, Application, and Menu Application 
templates. JFactory lets you change the 
type of code to be generated for the pro- 

fa) 

attach "forumname" "username" "" 
detach "forumname" "username" "" 
create "forumname" "username" "" 
post "forumname" "username" "message" 
close "" "username" "" 

(b) 

post "forumname" "username" "message" 
add "forumname" "" "" 

Table 1: (a) Commands the 
ForumDispatcher object understands; 
(b) commands understood by the 
ForumViewDispatcher object. 
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Figure 2: JChat main window. 



Figure 3: Error dialog. 


ject (application versus applet) at any time 
by changing the project’s Type property. 
Be careful, however, as security restric¬ 
tions differ. (For example, a Java applica¬ 
tion can write to a local disk, but an ap¬ 
plet cannot.) 

Once a new project is created, the Pro¬ 
ject Manager, Object Manager, and Tool 
Palette windows arrange themselves on 
screen (see Figure 1). If you don’t like the 
default window arrangement, JFactory al¬ 
lows you to choose three others. If your 
workspace gets cluttered, a menu-item se¬ 
lection will reorganize to the layout you 
have specified. The Project Manager lets 
you view, add, and modify every control 
in the project in a hierarchical way. The 
Object Manager consists of tabbed sheets 
that list the properties and events for ev¬ 
ery object that can lie changed or handled 
from within the JFactory interface. Select¬ 
ing an object in the Project Manager will 
instruct the Object Manager to display the 
current property and event settings for it. 

There are five steps required to build 
an application such as JChat: 

1. Design the Main window (see Figure 
2). You use the Window Designer to 
do this. 

2. Design the connection-error dialog. This 
will cause an error message like Figure 
3 to pop up when an error occurs dur¬ 
ing connection to the server. 

3. Design the forum-list window (Figure 
4) and new forum dialog. 

4. Design the forum-view window: the 
window in the JChat GUI that lets users 
view and add to the discussion taking 
place in a particular forum. 

5. Test the prototype (Figure 5) by se¬ 
lecting the Test app button on the JFac¬ 
tory toolbar. 

Adding User-Defined Code 

Once you’ve tested the GUI for function¬ 
ality, you can begin adding the code that 
will be used to make the connection with 
the JChat server. JFactory provides protect 
blocks that prevent user code from being 
deleted across subsequent code regener¬ 
ation. 

Before adding any Java source code, 
look at the code JFactory generates for 
handling the event when the Connect but¬ 
ton is pressed. Pressing the Generate but¬ 
ton on the JFactory toolbar, then brows¬ 
ing die code to find the action method for 
the Main window results in Listing One 
(listings begin on page 85). Notice that 
there are two sets of protect blocks, one 
to allow user-defined code to be entered 
before the window is shown and anoth¬ 
er for after the window is shown. For 
this particular case, we want to add user- 
defined code before the window is shown. 
If the connection with the server fails, a 


return from the event handler with a True 
value will complete the event-handler 
chain of events for the button hierarchy. 

Right after the MainConnectbutton- 
ClickedShow protect block, Socket , Con¬ 
nection , and Forum ViewDispatcher ob¬ 
jects are declared. The Connection object 
encapsulates the client/server communi¬ 
cation details. The ForumViewDispatcher 
object encapsulates the details of how the 
commands are processed as they come 
over the socket, and which Text Area will 
be updated. A try-catch block around the 
Socket instantiation is where an Exception 
can be thrown if the connection fails. For 
JChat, a server port number of 6600 was 
hardwired into the source code. If an Ex¬ 
ception is caught, the ErrorDialog is de¬ 
clared, instantiated, and shown before con¬ 
trol leaves the event handler. 

If the socket connection with the serv¬ 
er succeeds, the Connect button is dis¬ 
abled and a Connection object is instan¬ 
tiated. The Connection object is used by 
both the client and the server. To specify 
that the newly instantiated Connection ol> 
ject is the Client, the user name entered 
into the UserName Edit control must be 
passed to the setClientO method. The 
Connection is then handed to the Dis¬ 
patcher ; and the listbox in Forum List - 
Window is added as an object to notify 
when a new forum is created. The refer¬ 
ences of these newly created Connection 
and ForumViewDispatcher objects are 
passed to the newly created ForumList- 
Window object. To do this, two public 
data members are added to the Fonim- 
ListWindow object. 

Each class generated by JFactory has 
protect blocks for user-defined methods 
and data members. The code for the 
Connection and Dispatcher data mem¬ 
bers is shown in Listing Two, and the 
event-handler code for the Connect but¬ 
ton now looks like Listing Three. 

Now is a good time to ensure that the 
code that has been written is correct. Be¬ 
fore compiling the code, the packages and 
classes being used need to be imported. 
With JFactory, this is done by selecting 
the project icon in the Project Manager 
and then modifying the ImportFiles prop¬ 
erty in the Object Manager. Add COM 
.roguewave.jchat* and java. net.Socket to 
the list. It is important to verify that the 
CLASSPATH environment variable points 
to the base of the COM.roguewave.jchat 
package. 

Pressing the Generate & Make button 
on the JFactory toolbar generates and com¬ 
piles the Java source code with die mod¬ 
ifications in the protect blocks. 

Since the JChat client is an applet, 
JFactory also generates an HTML file that 
is viewable with appletviewer or any 
other Java-enabled browser. To test the 
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client, theJChat server must first be run¬ 
ning on the same machine that the Client 
is served from. Pressing the Run App 
button on the JFactory toolbar will dis¬ 
play the JChat main window in ap- 
pletviewer (the default HTML viewer). 
Pressing the Connect button will display 
the ForumListWindow . So far, JFactory 
has helped design the entire GUI and 



List of Forums 


has required less than 20 lines of user- 
defined Java source code to connect to 
the server. 

ForumListWindow needs to keep track 
of all the forums that are currently being 
viewed by the user. ForumListWindow 
also needs to handle the events for the 


ForumList , Join Forum, and New Forum, 
and Close Connection buttons. Further¬ 
more, any time users destroy ForumList- 
Window ; the connection with the server 
should be safely terminated. 

To keep track of all the forums that are 
currently being viewed by die user, a data 



Enteryourname: 


Jm Crooto Now Forum Dialog 


Enter Name for New Forum: 


I Testing JChaC 


Cancel 


NewForum. 


m 
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| Join Forum... | 

j NewForum.. | 


Close Connection 


28) w;h: (156. 214) ForumUsWindow 


Close Connection 


Figure 4: T/je forum list window. 


Figure 5: Testing the JChat GUI. 
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member can be added to the ForumList- 
Window object. A Vector can be used as 
the collection object, and this will have to 
be instantiated in the constructor. To add 
the code for the Vector instantiation in 
JFactory, SourceCode is chosen for the 
constructor event in the Object Manager’s 
Events sheet for the ForumListWindow. 
Listing Four shows the user-defined code 
that needed to be added to the JFactory- 
generated source code. The Join Forum 
button is initially disabled. When the user 
selects a forum in the ForumList, it should 
be enabled. To enable the Join Forum but¬ 
ton, the line pJoinButton,enable() } had to 
be added as SourceCode to the selection 
event for ForumList l ; see Listing Five. When 
the deselect event occurs, the Join Forum 
button should be disabled. Listing Six pre¬ 
sents the code that needs to be added. 

Another event that is important to han¬ 
dle is the destroy event for the ForumList - 
Window. Both the Close Connection but¬ 
ton and this event should safely close the 
connection. A cleanup() call was added, 
since the same method is used when the 
Close-button-clicked event occurs. Listing 
Seven is the code for all these changes. 

When the user clicks on the New Fo¬ 
rum button, the Connection instance must 
be passed to the Dialog object. This is 
done by declaring a data member that is 
publicly accessible. Listing Eight is the 
code for passing the reference. 

When the Join Forum button is clicked, 
the forum that is to be joined needs to be 
added to the vector of forum views. The 
title of the window will be modified so 
that the user can distinguish which forum 
a particular instance of Forum ViewWindow 
is viewing. The ForumArea object in the 
ForumViewWindow needs to be added to 
the dispatcher. When a message posted 
to that particular forum arrives, the dis¬ 
patcher will then be able to update the 
ForumArea object with the message. A 
command needs to be sent to the JChat 
server informing it that another user has 
connected to a particular forum. Listing 
Nine is the Java source code to implement 
these details. 

Attaching Functionality to the 
NewForumDialog 

A Connection data member needs to be 
added to the NewForumDialog object, so 
the ForumListWindow can reference it 
when the OK-button-clicked event occurs. 
The code for adding the Connection data 
member is shown in Listing Ten. When the 
OK button is pressed, the server should 
receive a create- new- forum command. List¬ 
ing Eleven is the code to be added. The 
JChat server will parse the command, cre¬ 
ate a new Forum object, and notify all the 
existing connections of the new forum that 
needs to be added to their list. 


Pressing the Make button on the JFac¬ 
tory toolbar compiles the Java source code 
with all the modifications that have been 
made in protect blocks. There is no need 
to regenerate the source code, since the 
GUI has not been modified. The JChat 
client can now connect to the server and 
add new forums to the list of forums in 
the ForumListWindow. The disabling and 
enabling of the Join Forum button can 
now be tested to ensure it is working as 


The JChat server is 
an asynchronous 
multithreaded Java 
application 


it should. Destroying the window or press¬ 
ing the Close Connection button should 
safely close the socket connection and re¬ 
enable the Connect button in the Main 
window. A forum is joinable but the func¬ 
tionality to post messages to one has not 
been added. 

Attaching functionality to the 
ForumViewWindow 

The ForumViewWindow appears when 
the Join Forum button is clicked. The Fo¬ 
rumViewWindow object will need two 
data members, one for the connection, 
and one that represents the forum name 
that is being viewed. Listing Twelve is 
code for adding these data members 

There are three events that must be 
handled in the ForumViewWindow. The 
Options/Exit menu item should close Fo¬ 
rumViewWindow and inform the server 
that this connection is no longer viewing 
this particular forum. The WINDOW. 
DESTROY event should also be handled, 
and it should do the same thing as Op¬ 
tions/Exit. 

To handle the Options/Exit event, the 
Window Designer for the ForumView¬ 
Window cm be opened by double-clicking 
on it in the Project Manager. Selecting 
the Options/Exit menu item and then 
choosing SourceCode for the selection 
event in the Events sheet in the Object 
Manger will bring up the source-code 
editor with the cursor right at the place 
where the code was entered; see Listing 
Thirteen. To handle the WINDOW. 


DESTROY event in the same way, I added 
Listing Fourteen. 

The last event that needs to be handled 
is the Post-button-clicked event. This event 
informs the server that a new message has 
been posted to a particular forum. Listing 
Fifteen is the source code for this event. 

At this point, the JChat client is fully 
functional. Pressing the Make button from 
the JFactory toolbar compiles the rest of 
the changes to the bytecode. 

Technical Issues and Solutions 

Netscape will only allow a Java applet to 
connect to a server that is running on the 
same machine that the client is served 
from. I had originally planned to let users 
choose which port and server they wished 
to connect to. This adds complexity, and 
Netscape’s limitations actually made the 
Main window of the JChat client more user 
friendly. However, this forces the Java serv¬ 
er to be running on the HTTP server, 
which in some environments may not be 
reasonable. 

Due to this security restriction mandat¬ 
ed by Netscape 2.0, the JChat user is not 
required to enter the address of the serv¬ 
er they wish to connect to. It is possible 
to get the full hostname of the HTTP serv¬ 
er that the applet was served from with 
the line of code appletgetCodeBase(J.getH- 
ost(). The object applet must be an in¬ 
stance of Applet or an object that extends 
(or subclasses) Applet. 

Summary 

JFactory makes it possible for you to 
rapidly prototype and design GUIs via 
drag-and-drop, point-and-click inter¬ 
faces. Source code to handle events can 
then be added to the generated GUI 
code between protect blocks via the 
Events sheet in the Object Manager. Af¬ 
ter functionality has been attached in the 
form of user-added Java source code, 
the controls can be moved around with¬ 
out changing any source code that 
you’ve written to add functionality. The 
most time-consuming part in creating 
JChat was writing the Java source code 
to enable the client to communicate 
properly with the server. 


For More IrifermoKbi) 

Rogue Wave Software 
850 SW 35th Street 
Corvallis, OR 97333 
800-487-3217 

http://www,roguewave;Com< 
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SHOPPING CART 


listing One 

I!/usr/bin/perl 
9 minishopl.cgi 

# A simple shopping cart CGI script written by Chris Baron 

# for Dr. Dobb's Journal. This code nay be freely used and codified. If 

# you use Minishop as a starting point for anything please reference where 

« you got it. I'd appreciate a copy of the script. 

I Comments or questions? Send me email at cbaron0egrafx.com 

# This script uses the HIDDEN attribute for a text field to store the data in 
I the shopping cart. This data is updated each tine the user 

# executes the script. 

# This script uses the cgi-lib.pl v2.4 utility nodule 

# by Steven Brenner (S.B.Brenner0bioc.cam.ac.uk) 
f http://www.bio.cam.ac.uk/cgi-lib/ 

# tells Perl to use the cgi-lib.pl module 

require 'cgi-lib.pl'; # in sane directory as the script or in 0INC 

# our script name 

$self ® $ENV('SCRIPT_NAME'): 

# initialize the catalog. For a real system you would want to store in 

# a database for ease of maintenance and flexibility to add and delete 

# new products 

I 

9 the format of the catalog is — 

I part#, title:price:nun-disks:weight 
/catalog ( 

'cd001', 'Algorithms and Data Structures:59.95:1:0.1', 

•cd002\ 'WWW Toolkit:29.95:1:.1'. 

’cd003', 'Graphics Programing Books:69.95:1:0.1', 

■cd004\ q/Dr. Dobb's on CD-ROM:79.95:2:0.2/. 

'cd005’, '386BSD Reference:99.00:1:0.1'. 

*cd006', 'Alternative Languages:49.95:1:0.1'): 

# MAIN routine 
MAIN: 

{ 

# Read in all the variables set by the form 

if (&ReadParse(*form)) ( # if true there were parameters 
$to_do = $fom{'action'); § fetch the command 

) 

else C # called with no parameters i.e. initial call 
$to_do = 'display'; ijust show the catalog 

I load the cart data into an array for use if any 
&get_state; 

t the Perl equivalent of a switch statement to display the proper page based 
I on which submit button was pressed or action parameter was passed 

switch: ( 

if (($to.do eq 'display') || ($to_do eq 'Return')) { 

&shov_cat; last switch: ) 

if ($to_do eq 'shovitem') ( &shov_item_page($form('page')): 
last switch: ) 

if ($to.do eq 'Show Cart') ( &show_cart; last switch; ) 

if ($to_do eq 'Buy/Update') { &add.item($form('item'). $form('num')); 

Sshow.cart: last switch: ) 

if ($to_do eq 'Check Out') ( &check_out; last switch: ) 

if ($to_do eq 'Empty Cart') ( fienpty.cart: Sshow.cat; last switch: ) 

&CgiError('Boo Boo'. 'Bad Command none Hatched'. 

&PrintVariables(/form)); 

} > end of MAIN 

HIM#!liftItltfflit# State Subroutines 0tiltm#*f III ftlttSIHt 

# get.state. here is where we fetch the state data from the hidden field 
» and load it into an associative array for use 

sub get.state { 

/cart.data * split$form£*cartdata')); 

# maintain.state. Here is where the hidden cart data is stored into the form 

# the hidden type creates a string for use in an input field with a 

# tag like <INPUT TYPE® "HIDDEN" NAKE="cartdata" VALUE®"$cart_out"> 
sub maintain.state ( 

if (/cart.data) { 

$cart_out = join(":", /cart.data); 

) 

I add.iten. add an item to the shopping cart the state consists of an array 

# of part numbers with a non-zero quantity a quantity of zero means delete it 
sub add.item ( 

local ($iteo, $num) = 0_; 

if ($num ®® 0) ( delete $cart_data{$item) } 

^ else ( $cart_data{$item) = $num: ) Ithis does a simple overwrite 

I enpty.cart. empty out the cart by simply undefing the /cart.data array 
sub enpty.cart ( 

undef /cart.data; 

) 

I print.type. Prints out the magic "Content-Type: text/html" line 
sub print.type ( 

print "Content-Type: text/html\n\n": 

999999999999999999999 Display Subroutines 

# show.cat. show the catalog index page 
sub show.cat { 

Sprint.type: 9 the content-type: line 

toalntain.state; # this generates the state information 

print &HtmlTop("Minishop On-Line CD-ROM Catalog"): 

print "<P>This catalog uses the type=HIDDEN form method of \n": 

print "maintaining state information between pages."; 

print "<P>Please click on an item to view more detail or to order it.\n"; 

print "<P> <CENTER><TABLE BORDER)\n": 


print "<TR><TH>Current CDs In Stock</TH></TR>\n"; 

# sort for display foreach $itea (sort keys(/catalog)) ( 

{$name. $price, $nua_cd. $vt) ® split(':',$catalog($item)); 
print qq«TRXTD>): 

print qq(<A HREF="$self?action=showitem&page a $item&cartdata° 

$cart.out">): 

print "$name</A></TDX/TR>\n": 

) 

print "</TABLE></CENTER>\n": 

print qq«PXCENTBRXFORM ACTION®"$self" KSTHOD="POST"» ; 
print qq«INPUT NAME®"action" TYPE-"SUBMIT" 

VALUE 13 "Show Cart" ALIGN=left>\n); 
print qq«INPUT NAME®"action" TYPE="SUBMIT" 

VALUE a "Empty Cart" ALIGN=center>\n); 
print qq«INPUT NAME="action" TYPB*"SUBMIT" 

VALUE 13 "Check Out" ALIGN®right>\n); 
print qq«INPUT KAME«"cartdata" TYPE®"HIDDEN" VALUE="$cart.out"»; 

* print &PrintVariables(/form); #«#«*##«* debugging 
print " </FORM> </CENTER) </BODYX/HTML>\n"; 

) 

9 show.item.page. show the page for an individual item 
sub show.itea.page C 

local($item) = pop(0_); 

($naco, $price. $nua.cd, $wt) = split(':'.$catalog($item)); 

Sprint.type: # the content-type:.line 

&maintain_state: 9 this generates the state information 

print &HtnlTop("Catalog Page for $name"): 

print "<P>Here is where you would place the picture and 
print "description of this item"; 

print "you would want to store the description in a database 
print "along with a reference to the graphic image etc.\n"; 

print qq«PXFORM ACnON="$self" METHOD 33 "POST")); 

print qq (<CENTER>CTABLB BORDER WIDTH®"100/">\n); 

print "<TRXTHX/THXTH>Itea</TH>"; 

print "<TH)No. CDs</TH><TH>Price</TH)</TR>\n"; 

$val = ($cart_data($item)) ,'S 1: 

print qq(<TRXTDXINPUT NAHE="num" TYPE="TEXT" VALUE="$val"); 
print qq( C0LS=2 SIZE®"5"X/TD>\n); 
print "<TD>$nane</TDXTD>$num_cd</TDXTD>$price</TD>"; 
print "</TRX/TABLE)\n": 

print qq«PXTABLB BORDER-0 WIDTH-" 100/"XTR>\n); 
print qq(<TD)<IN?UT NAKE®"action" TYPE="SUBMIT" 

VALUE®"Buy/Cpdate"X/TD>\n); 
print qq(<TDXINPUT NAME®"action" TYPE°"SUBMIT" 

VALUE 33 "Show Cart" ALIGN=left></TD>\n); 
print qq«TD><INPUT NAME»"action" TYPE="SUBMIT" 

VALUB®"Empty Cart" ALIGN=leftX/TD>\n); 
print qq«TDXINPUT NAME«"action" TYPE 3 "SUBMIT" 

VALUB®"Check Out" ALIGN=left></TD>\n); print 

" </TRX/TABLE) \n"; 
print "</CBNIER>"; 

print qq«INPUT NAHB®"cartdata" TYPE®"HIDDEN" VALUE= H $cart.out"»; 

I print &PrintVariables('/form); 999999999 debugging 

print qq(< INPUT NAME®" item" TYPE="HIDDBN" VALUE®" $ item")): 

print "</FORM)\n"; 
print "</BODYX/HTML)\n"; 

# show.cart. display the entire cartfull of stuff 
sub show.cart ( 

Sprint.type: 

&maintain.state: $ this generates the state information 

print &HtmlTop("Your Shopping Cart"); 

if (t keys /cart.data) ( # shortcut if nothing in cart 
print "<P>Is empty."; 

else ( 

print "<P)Listed below is your current shopping cart\n"; 
print "<UL)\n"; 

print "<LI)Review the contents of your cart An"; 
print "<LI)To delete an item "; 

print "click on the name and change the quantity to zero\n": 
print "<LI)To change the quantity click the item nama\n": 
print "<LI)To completo your order click the 'Check Out' button.\n": 
print "</UL>\n"; 
print "<P>\n"; 

print qq(<CENTER)<TABLE BORDER®1 WIDTH 33 "100/" ALIGN=CENTER>\n); 
print "<TRXTH>Quantity</THXTH>Itea</TH>"; 
print "<TH)Price</TH>\n"; 

# we uso the part number to relate the cart_data and catalog entries 
foreach $item (sort keys(/cart.data)) ( # sort for display 

$num = $cart_data{$item); 

($name, $price, $num.cd, $wt) ® split(';',$catalog($item)); 

print "<TR>"; 

print "<TD>$num</TD)\n"; 

print qq(<TD>); 

print qq(<A HREF®"$self?action®showitem&page®$item&cartdata® 

$cart_out">): 

print "$name</AX/TD>\n"; 
print "<TD)$price</TD>\n"; 
print "K/TR)^"; 

) 

print "</TABLEX/CENTER)\n"; 

) # end of else 

print qq«PXFORM ACTION="$self" METHOD®"POST"» ; 

0continued on page 84) 
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System Commander ™ makes it safe and easy to add 
as many operating systems to your PC as you want! 
Quick and Easy Installation. 

System Commander will have your PC ready to add 
new operating systems in less than 5 minutes. It does not 
require repartitioning, nor a partition of its own. 

The first reboot brings up a menu of the operating 
systems already installed. Select the one you want and 
System Commander does the rest. 

Saves You Time and Effort. 

As you install new operating systems, System Com¬ 
mander saves the key files and adds the new OS to the 
System Commander menu. 


Srcitn CurrwiotK ■ 

.1 S& pc-dos ?.f; 

B Novell Dor ? 
r J& Uii.W; Ml 
D )Jbx SCO Unix 

i Jj Uindous % 


\ "Highly recommended" \ 

John C. Dvorak Rj3 
PC MAGAZINE 143 
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System Commander makes it safe and easy to evalu¬ 
ate new operating systems without giving up the 
reliability of your existing OS. 

Saves You Money! 

Instead of investing thousands of dollars in new PCs, 
you can now have as many as 100 operating systems on 
one PC with up to 14 hard drives of any size or type. 

System Commander is only $99.95 and comes with a 
60 day money-back, guarantee. For a limited time, get 
FREE overnight shipping when you mention this ad*. 



Call now! 
1 - 800 - 648-8266 

60-DAY MONEY-BACK GUARANTEE 
V Communications, Inc 
' 4320 Stevens Creek Blvd., Suite 120-DD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 
*When ordered before noon PST. Extra charge for Saturday delivery. Standard shipping outside US. 
CA residents add $7.25 sales tax. Offer subject to change without notice. All logos and product 
names are trademarks of their respective companies. VISAMC/Amex/COD © 1995 


(continued from page 83) 

print qq(<PXTABLE BORDER=0 WIDTH="100/"XTR>\n); 
print qq(<TDXINPUT NAME="action" TYPE= M SUBMIT" 

VALUE="Return"X/TD>\n); 

print qq(<TDXINPUT NAME="action" TYPE="SUBMIT" 

VALUE="Empty Cart" ALIGN=left></TD>\n): 
print qq(<TDXINPUT NAME="action” TYPE="SUBMIT" 

VALUE="Check Out" ALIGN=leftX/TD>\n); 
print "</TRX/TABLE>\n": 

print qq(<INPUT NAME="cartdata" TYPE="HIDDEN" VALUE="$cart_out">): 

# print &PrintVariables(/form); ######### debugging 
print "</F0RM>", &HtmlBot; 

) 

# check.out. generate the order page 
sub check.out ( 

fcprint.type: 

^maintain_state; # this generates the state information 

print &HtmlTop("Your Order"); 

print "<P>Here is your order<P>Please review it. If everything is 0K\n"; 
print "Then fill in the information below and click the 'Order' button\n"; 
print "Your order will be on it's way in no time (literally)An"; 

print "<CENTERXTABLE B0RDER>\n": 

print "<TRXTH>Iten</THXTH>Quantity</TH>"; 

print "<TH>Price</THXTH>Total</TH></TR>\n"; 

foreach $item (sort keys(/cart_data)) ( f sort for display 
$num = $cart_data($item); 

($name, $price, $num_cd, $wt) = split(':', $catalog($item)); 

$sub_tot = $num * $price; 

$weight += $num * $wt; 

$grand_tot += $sub_tot; 

print "<TRXTD>$name</TDXTD>$num</TDXTD>$price</TD>": 
print "<TD>". sprintf ("/7.2f".$sub_tot). "</TDX/TR>\n": 

) 

print "<TRXTDX/TDXTDX/TD>"; 

print "<TH>Sub Total :</THXTH>": 

print sprintf("/7.2f",$grand_tot), "</THX/TR>\n"; 

Sshipping = $weight * 3; 
print "<TRXTDX/TDXTDX/TD>"; 

print "<TH>Shipping</THXTH>", sprintf("/7.2f",$shipping). "</THX/TR>\n": 

$tax = $grand_tot*0.085: 
print "<TRXTDX/TDXTDX/TD>"; 

print "<TH)Tax: </THXTH>", sprintf("/7.2f".$tax). "</THX/TR>\n": 

print "<TRXTDX/TDXTDX/TD>"; 

print "<TH>Grand Total;</THXTH>"; 

print sprintf("/7.2f".$grand_tot+$tax+$shipping): 

print "</THX/TR>\n"; 

print "</CENTERX/TABLE>"; 

* An ugly shipping information form. In a production system you could read 

# this data from a registered user database and not require users to input 

# shipping and payment data each time. This also increases security. 

print <<EndofForm 

<F0RM ACTI0N="$self" METH0D="P0ST"> 

<INPUT NAME="action" TYPE="SUBMIT" VALUE="Return"> 

<INPUT NAME="action" TYPE="SUBMIT" VALUE="Empty Cart"> 

<HR> 

Your Name: <INPUT NAME="name" TYPE="TEXT" COLS=30 SIZE="50"XBR> 

Street Address: <INPUT NAME="addr" TYPE="TEXT" COLS=50 SIZE="60"XBR> 
City: <INPUT NAME="city" TYPE="TEXT" C0LS=15 SIZE="60"XBR> 

State: <INPUT NAME="state" TYPE="TEXT" C0LS=2 SIZE="5"> 

Zip: <INPUT NAME="zip" TYPE="TEXT" C0LS=12 SIZE="12"> 

Country: <INPUT NAME="country" TYPE="TEXT" C0LS=12 SIZE="12"> 
<CENTERXHR WIDTH="50/"X/CENTER> 

Method of Payment: Visa <INPUT NAME="pmt" TYPE="RADIO" VALUE="visa"> 
Master Card <INPUT NAME="pmt" TYPE="RADIO" VALUE="nc"> 

Discover <INPUT NAME="pmt" TYPE="RADI0" VALUE="dis"XBR> 

Card «: <INPUT NAME="card" TYPE="TEXT" C0LS=15 SIZE="20"> 

Expiration: <INPUT NAME="exp" TYPE="TEXT" C0LS=9 SIZE="20"XBR> 
<CENTERXHR WIDTH="50/"X/CENTER> 

Shipping Method: <SELECT NAME="ship" VALUE="FedEx" SIZE= 1> 

<0PTI0N>U.S. Mail 
<0PTI0N>UPS Ground 
<0PTI0N>UPS Air 
<0PTI0N>FedEx 
</SELECT> 

<PXINPUT NAME="action" TYPE="SUBMIT" VALUE="Send Order") 

<INPUT TYPE="RESET") 

<INPUT NAME="cartdata" TYPE="HIDDEN" VALUE="$cart_out"> 

</F0RM> 

EndofForm 

) 

#eof Minishop.cgi shopping cart demo 

Listing Two 

# get.state. Here is where we fetch state data from cookie environment variable 
i and load it into an associative array for use cookie string looks like 

# namel=valuel; name2=value2 ... 
sub get.state ( 

$cookies = $ENV('HTTP_C00KIE'): # contains all cookies 

$cookies =~ /cartdata=(\S+)(;!)/: # up to : or end if last cookie 

$our_cookie = $1; 

/cart.data = split(":". $our_cookie); 

) 

# maintain.state. Here is where the cookie data is sent to the browser. 

# The browser stores the cookie in its cookie-file until it expires. The 

# expires parameter should be used to keep cookies from getting too stale :-) 
sub maintain.state ( 

if (/cart.data) ( 

$cart_out = join(":", /cart.data); 
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print "Set-cookie: cartdata=$cart_out:": 

print "expires=Thursday. 01-Jan-98 12:00:00 GMT\n\n": # note \n\n 

) else ( 

print "Set-cookie: cartdata=:": 

* ve put in a time which has past to erase the cookie 
print "expires=Monday. 06-May-96 12:00:00 GMT\n\n": 

) 

* print.type. Prints out the magic "Content-Type: text/html" line 
sub print.type ( 

print "Content-Type: text/html\n"; »## note only one \n 


Listing Three 

* get_state. Here is where we fetch the state data from the database. 

* We use a cookie to store a unique UserlD and use it to access the database 

* file to get the shopping cart data, 
sub get.state ( 

# create an expiration string for the Userid cookie so they don't 

# last forever. 

Sexptime = time + 86400; * one day later than now 
($s. $m. $h. $d. $mo. $y, $w) = gmtime(Sexptime): 

$expdate=$week[$w].'.'.$d..$mon[$mo]..$y.' '.$h.':'.$m.':'.$s.' GMT': 

# now get the UserlD cookie 

Scookies = $ENV('HTTP_COOKIE'); I contains all cookies 
Scookies =~ /UserID=(\S+)(;!)/; # up to : or end if last cookie 

Suserid = $1: 

# if the UserlD doesn't exist we make one 
if (! Suserid) ( 

dbmopen(/db_id.$id_base. 0666) || 6CgiDie("Couldn't open user id dbm"): 
Suserid = ($db_id(id_num) +=1): 
dbmclose(/db_id): 

) 

# Now read the cart data from the cart database. It may be blank. 

# Note, there is no timeout built into this database. 

i It will continue growing forever. Adding an expire function to 

# clean out the old cart data is left as an exercise for the reader. 
dbmopen(/cart_db. Scart.base, 0666) || &CgiDie("Couldn't open cart dbm"); 
Scartdata = $cart_db($userid): 

dbmclose(/cart_db): 

i now we have the data in a usable form 
/cart.data = split(':', Scartdata): 

) 

* naintain.state. Here is where the cookie data is updated for expiration 

* and the cart data is stored into the database file. The browser stores the 

* cookie in its cookie-file until it expires. The expires parameter should be 

* used to keep the cookies from getting too stale :-) 
sub maintain.state ( 

# set the expiration data to this data plus one. 

print "Set-cookie: UserID=$userid; expires=$expdate;\n\n"; 

# store the cart data into the database or a null record 

# if the cart has been emptied. 

dbaopen(/cart_db. Scart.base, 0666) !i &CgiDie("Couldn't open cart dbm"): 
if (/cart.data) { 

Scart.out = join(":", /cart.data): $cart_db($userid) = 

Scart.out; 

) 

else ( 

delete $cart_db($userid); 

) 

dbmclose(/cart_db); 
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Listing One 

public boolean action(Event evt. Object obj) { 
if (evt.target == pConnectButton) ( 

ForumListWindow wForumListWindow=new ForumListWindow(applet."Forums List"): 
// zpb.begin MainConnectButtonClickedShow 
// zpb.end 

wForumListWindow.showO : 

// zpb.begin MainConnectButtonClicked 
// zpb.end 

) 

// zpb.begin MainAction 
// zpb.end 
return true: 


Listing Two 

// zpb.begin ForumListWindowUserVars 
Connection connection: 

Dispatcher dispatcher: 

// zpb.end 


Listing Three 

public boolean action(Event evt. Object obj) ( 
if (evt.target == pConnectButton) ( 

ForumListWindow wForumListWindow=new ForumListWindow(applet,"Forums List"); 

// zpb.begin MainConnectButtonClickedShow 
Socket aSocket = null: 
try ( 

aSocket = new Socket(applet.getCodeBase().getHostO. 6600); 

) catch (Exception e) ( 

ErrorDialog eDialog = new ErrorDialog(applet,null,"Error Dialog",true): 
eDialog.showO ; 
return true: 

) 

(continued on page 86) 


v 


Our Experience ... 
Your Solution! 


* 

P 



► Object Oriented C++ using MFC 

► MFC for C++ Developers 

^ MFC with ODBC,Win 32 

► MFC for Windows 95 

^ MFC for Windows NT 

^ Advanced MFC and OLE — 
includes ActiveX 

► OLE Objects using MFC — 

includes ActiveX 

Let Leading Design Put You In A Class All Your Own: 

Leading Design is introducing a brand new curriculum of customized 
course modules which we will deliver on-site at your facility. These inten¬ 
sive, hands-on training programs are designed to adapt to your specific 
needs. Our experience transitioning many Fortune 500 companies is an 
essential element in the development of our advanced and specialized 
courses. It is this same unmatched experience you’ll find in Leading 
Design's full curriculum ofWindows courses. 

Learn From Our Experience: Leading Design has spent more than a 
decade helping leading corporations around the globe successfully infuse 
their businesses with the advantages of object technology. Developers, 
programmers, designers, architects and managers can benefit immediately 
from the real-world experience of our instructors and consultants. 

Leading Design’s Clients Include: IBM, Hewlett Packard, Sprint,Texas 
Instruments, Intel, NCR/AT&T, Xerox, Chevron, Microsoft, Chase 
Manhattan, Lotus, Honeywell and many others. 

Register Today For The Future 


Call 1-800-355-9845 
On-Site And Group Discounts 


Starting dates for 5-day courses: includes Software 

and Manual 


MFC 

OLE 

OWL 

Boston 
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Call 

Chicago 

8/5, 12/2 
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10/7 

10/14 
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Dallas 

9/9 

9/16 
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Atlanta 

11/4 

ll/ll 

Call 

Other 

Locations 

Call 

Call 

Call 


3417 Fremont Avenue North 
Suite 221 • Seattle, WA 98103 U.S.A. 
Phone: (206) 547-5985 
Fax: (206) 547-5988 
E-mail: 76306.343@compuserve.com 
design Web Site: http://www.ldesign.com/ 
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pConnectButton.disable(): 

ForumViewDispatcher aDispatcher = new ForumViewDispatcher(): 

Connection aConnection = new Connection(aSocket. aDispatcher); 
aConnection.setClient (pUserName.getTextO); 
aDispatcher.addConnection(aConnection); 

aDispatcher.addObjectToNotify("_FORUM_LIST_".wForumListWindow.pForumList); 
wForumListWindow.connection = aConnection; 
wForumListWindow.dispatcher = aDispatcher; 

// zpb.end 

wForumListWindow.show(); 

// zpb_begin MainConnectButtonClicked 
// zpb.end 

) 

// zpb.begin HainAction 
// zpb.end 
return true: 


Listing Four 

// zpb_begin ForuoListWindowUserVars 


private Vector views,; 

// zpb_end 

ForumListWindow(Applet app. String title) ( 
super(title): 
applet = app; 

// zpb.begin ForumListWindowConstructor.l 
views, = new VectorO: 

// zpb.end 


Listing Five 

public boolean handleEvent(Event e) { 

if (e.target == pForumList && e.id == Event.LIST,SELECT ( 

// zpb.begin ForumListWindowForuaListSelect 
pJoinButton.enable(); 

// zpb.end 
return false; 

) 

) 

Listing Six 

public boolean handleEvent(Event e) ( 

if (e.target == pForumList && e.id == Event.LIST,DESELECT { 
// zpb.begin ForuaListWindowForumListDeSelect 


pJoinButton.disable(); 
// zpb.end 
return false; 

) 

) 


Listing Seven 

public boolean handleEvent(Event e) ( 

if (e.id ==Event.WINDOW.DESTROY) { 

// zpb.begin ForumListWindowDestroy 
cleanup(); 

// zpb_end 
disposeO; 
return true; 

) 

) public boolean action(Event evt. Object obj) ( 

else if (evt.target == pCloseButton) ( 

// zpb.begin ForumListWindowCloseButtonClicked 
cleanup 0: 
disposeO: 

// zpb.end 

) 

) 

// zpb.begin ForumListWindowUserMethods 


public synchronized void cleanup() ( 

Enumeration viewEnumeration = views..elements(): 
while (viewEnumeration.hasMoreElements()) 

((ForumViewWindow)viewEnumeration.nextElementO).cleanup(): 
String[] command = new String[4); 
command[0] = "close"; 
command[2] = connection.getUser(); 
connection.send(command); 
dispatcher.stop(); 
connection.close(); 

((Client)applet).pConnectButton.enable(); 

) 

// zpb.end 

Listing Eight 

// zpb.begin ForumListWindowNewForumButtonClickedShow 
dNewForumDialog.connection = connection; 

// zpb.end 




The UNIX Buyer's Guide. 

Now available on the world wide web, 
complete with thousands of product listings, 
and a free-text and fielded search engine. 


http://www.unixrevi ew.com 



Tired of Wrestling with OCX/DLLs?? 


You need SEC++ and Objective Grid ~two new MFC 
extensions that are 100% MFC compatible! 



Objective Grid (pictured) is a complete grid MFC extension. You can use the grid in a 
CView, CWnd and even as a popup. The grid can be bound to any external data source 
with one virtual override. Objective Grid also features complete ODBC/DAO support, print 
preview, find/replace, undo/redo. UNICODE/DBCS and an extensible control architecture. 

SEC++ is a group of over 40 MFC extensions including: docking views, zooming and 
panning CViews. image classes for DIB/GIF/JPG/PCX/TGA/TIhF. masked edit control, 
excel-like tabbed windows, calendar, color well, graphic buttons, a filesystem class, 
encrypting and compressing CFile derivatives and much more. 
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Listing Nine 

else if (evt.target — pJoinButton) { 

ForunViewWindow = newForumViewWindow(applet. "Forum Viewer"): 

// zpb.begin ForunListWindovJoinButtonclickedShov 
views..addElement(wForumViewWindow); 

wForumViewWindow.setTitle("Forum Viewer for "+ pForumList.getSelectedltemO); 
wForumViewWindow.forumName = pForumList.getSelectedltemO; 
wForumViewWindow.connection = connection; 
dispatcher.addObjectToNotify(pForumList.getSelectedltemO. 

wFommViewWindow.getForumArea()); 

String[] command = new String[4]; 
command[0] 3 "attach": 

commandilj = pForumList.getSelectedltemO: 
command[2] = connection.getUser(); 
connection.send(command): 

// zpb.end 

wForumViewWindow.show(): 

// zpb.begin ForumListWindowJoinButtonClicked 
// zpb.end 


Listing Ten 

// zpb.begin NewForumDialogUserVars 
Connection connection; 

// zpb.end 


Listing Thirteen 

public boolean action(Event evt. Object obj) { 
if (evt.target instanceof Henultem { 

String label = (String)obj: 
if (label.equals("Exit")) { 

// zpb.begin ForumViewWindowOpotionsExitSelection 
cleanup(): 
dispose(); 

// zpb.end 

) 

return true; 


Listing Fourteen 

public boolean handleEvent(Event e) ( 
if (e.id == Event.WINDOW.DESTROY) ( 

// zpb.begin ForumViewWindowDestroy 
cleanup(): 

// zpb.end 
dispose(): 
return true: 

) 


) 


Listing Eleven 

public boolean action(Event evt. Object obj) 
if (evt.target = pOK) { 

// zpb.begin NewForumDialogOKClicked 
StringO command = new String(4): 
command(0) = "create": 
command[lj 3 pNewForuaName.getText(): 
connection.send(command): 

// zpb.end 
dispose(): 

return true; 

) 


Listing Twelve 

// zpb.begin ForumViewWindowUserVars 
String forumName: 

Connection connection: 

// zpb.end 


// zpb.begin ForumViewWindowUserMethods 
public void cleanupO ( 

String!) command = new String[4); 
command[0] = "detach"; 

command[lj 3 forumName; command[2] 3 connection.getUser(); 
connection.send(command); 

) 

// zpb.end 

Listing Fifteen 

if (evt.target 33 pPostButton) ( 

// zpb.begin ForumViewWindowPostButtonClicked 

String!) command 3 new String[4); 

command(0) 3 "post": 

commandtlj 3 forumName: 

command [2] 3 connection.getUserO ; 

command(3) 3 pPostMessageBox.getText(): 
connection.send(command): 

//zpb.end 
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HyperHelp also supports Frame- 
Maker MIF, HTML, SGML 
and ASCII text editors as author¬ 
ing file formats for online help. 
Best of all, the HyperHelp Viewer 
can be distributed royalty-free 
to your customers. For more in¬ 
formation on HyperHelp, call 
(203) 438-6969, visit our Web 
site at http://iuww.bristol.com , 
email info@bristol.com, fax 
(203) 438-5013 or download a 
free demo from fip.bristol.com. 
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Design: Whose Job Is It, 
Anyway? 



Michael Swaine 


F ew software products are loosed upon 
the unsuspecting world with as little 
thought as the editorial product de¬ 
scribed in the following vignette. This 
story is not so much a cautionary tale— 
you don’t need to be cautioned against 
doing something you’d never be fool 
enough to do — as it is a moron joke to 
set up this month’s theme. 

Since the time at which this story took 
place, editors have been changed to pro¬ 
tect the innocent reader. 

Back in October 1984, the then-editor- 
in-chief of this magazine introduced a col¬ 
umn in DDJ called “The Software De¬ 
signer.” By “introduced,” what I really 
mean is that this knucklehead announced 
in print that there would be such a col¬ 
umn, without first lining up a regular 
columnist to write it. The lack of an au¬ 
thor turned out to be a bit of a problem, 
especially for the aforementioned knuck¬ 
lehead-in-chief, who had to write most 
of the columns himself. The frequency, 
length, and content of the column were 
all, predictably, unpredictable. And yet, 
against all odds, the column seemed to 
strike a chord with readers. 

The right idea can sometime triumph 
over a poor design. 

A decade later, “Software Designer” is 
a real job title in some organizations, and 
there are schools offering multicourse pro¬ 
grams in software design, including a Mas¬ 
ter’s Degree program at the Royal College 
of Art, Stanford’s Master’s-level program 
in Human-Computer Interaction Design, 
and MIT’s Program in Media Arts and Sci¬ 
ences. A professional organization, the As¬ 
sociation for Software Design, has been 
formed. And while books on software de¬ 
sign aren’t as common as books on Java 
programming, there are several, many of 


the best of which have been discussed in 
this column. (Tog on Interface and Tog on 
Software Design , by Bruce Tognazzini; 
Computets as Theater, by Brenda Laurel; 
The Essentials of User Interface Design, by 
Alan Cooper; Things that Make Us Smart, 
by Don Norman.) 

Of course there were books on soft¬ 
ware design back in 1984, but they rarely 
used that term (Paul Heckel’s excellent Ihe 
Elements of Friendly Software Design, Warn¬ 
er Books, 1982-84, ISBN 0-446-38040-7, is 
the standout exception), and they general¬ 
ly didn’t treat software design as a sepa¬ 
rate discipline. If the poorly designed “'Hie 
Software Designer” nudged people’s think¬ 
ing just a little in that direction, maybe 
DDJ deserves a tiny bit of credit for the 
way things are moving. 

Less ambiguous credit is due to DDJ's 
15th anniversary issue in January 1991. That 
was the issue that focused explicitly on 
software design, with several software- 
design articles and a bold manifesto by 
Mitch Kapor urging that we all get serious 
about software design. “Credit,” that is, if 
you think that software design ought to be 
a separate discipline, which is the direction 
that issue was pushing things, especially 
through the Kapor piece. “Blame” other¬ 
wise. Tlie point is, after all, delxitable. Should 
software design be the job of a specialist, 
or should the implementor be the design¬ 
er? This month, I discuss a book that pre¬ 
sents the views of some twenty people on 
software design, and then I look at the lega¬ 
cy of one uncompromising developer who, 
probably more than anyone else, upholds 
die vision of die implementor/designer. 

Winograd School 

The book is Bringing Design to Software 
by Terry Winograd (ACM Press, 1996, 


ISBN 0-201-85491-0). Its purpose, ac¬ 
cording to ACM Press marketing, is “to il¬ 
luminate and stimulate the discipline of 
Software Design.” In structure, the book 
is a collection of essays by individuals widi 
some stake in software design, introduced 
by Winograd and alternating with “pro¬ 
files” by Winograd and odiers; these pro¬ 
files turn out to be descriptions of prod¬ 
ucts or projects that exemplify in some 
way the points made in each of the arti¬ 
cles. Without this structure and Winograd’s 
ordering of die contributions, these essays 
would read like a collection of papers pre¬ 
sented at a conference—which is more 
or less what diey are—rather than as a 
coherent exploration of a topic, which is 
how they do, in fact, read. 

This is impressive, given diat the book 
has contributions from a lot of “names,” 
and the usual result of pulling together 
essays from a conference with a lot of big 
names is incommensurate perspectives, 
redundant coverage, pursuing of tangents, 
and self promotion. Granted that Mitch 
Kapor, David Liddle, Paul Saffo, Peter Den¬ 
ning, John Seely Brown, Michael Schrage, 
and Don Norman all have somediing in¬ 
teresting to say about software design, I 
wouldn’t expect a book that includes all 
of diem to be anydiing but a loose bag of 
essays. Although Winograd cautions that 
the reader will have to share some of the 
burden of pulling the contributions to¬ 
gether into one coherent whole, it is to 
Winograd’s credit that this is indeed pos¬ 
sible, and that the book actually reaches 
conclusions by chapter 14 that it couldn’t 
have reached in chapter 1. 

Mitch's Pitch 

The one reprint in the book, and the lead 
article, is Mitch Kapor’s “Software Design 
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Manifesto.” This is the piece that appeared 
in the aforementioned January 1991 issue 
of DDJ, and it sets the right tone, speak¬ 
ing of poorly designed software as “the 
secret shame of the industry.” Kapor ar¬ 
gues for recognizing the separate and crit¬ 
ical role of design, draws a parallel be¬ 
tween building software and building 
buildings, and says that we have con¬ 
struction workers designing software when 
what we need are software architects. And 
he clearly states that we need formal train¬ 
ing and recognition of software designers 
as members of a separate profession, equal 
to computer scientists and engineers. 

The other contributions to the book take 
various forms. The Liddle piece is an in¬ 
terview. Although it covers what may be 
familiar material for some DDJ readers— 
the design of the landmark Star comput¬ 
er at Xerox, which soon put the gleam of 
Macintosh in Steve Jobs’s eyes—the em¬ 
phasis here is less on the Star and its in¬ 
fluence on user-interface design than on 
the process of design engaged in at Xe¬ 
rox at the time. It deals with a question 
that is definitely worth asking: What were 
the conditions, goals, forces that permit¬ 
ted the development of such a radical 
break with current thinking about what 
constituted a personal computer? 

If the Star experience had been an un¬ 
qualified success, the book could be a lot 
shorter: It could describe the Xerox cor¬ 
porate culture, design goals, experience 
of the designers, team structure, and the 
like, and then say, “Here is the secret of 
successful software design: Go thou and 
do likewise.” Well, the Star was not an un¬ 
qualified success. 

So when Liddle says, “Before we de¬ 
signed the Star, I commissioned a study 
that produced a document on methodol¬ 
ogy for the design of the user interface,” 
we are free to consider this as a factor 
contributing to a breakthrough design, or 
as one reason the Star bombed in the 
market. 

What It Is 

Perhaps the chief insight from the Liddle 
piece is his emphasis on the importance 
of the user’s conceptual model and his 
distinguishing it from a metaphor. The 
user’s conceptual model is not a metaphor, 
but what Ted Nelson calls a “virtuality.” It 
doesn’t have to represent some real-life 
thing; it becomes its own reality. Gillian 
Crampton Smith and Philip Tabor push 
the idea further: the Platonic assumption 
that there is something behind the inter¬ 
face is not true, in the user’s experience: 
“As far as the user is concerned, WYGI- 
WYS: What you get is what you see. The 
interface is the product.” 


If, to the user, the interface is the prod¬ 
uct, part of the design process needs to 
be deciding what the product is. David 
Kelly is explicit about this: He says that 
designers must “understand, observe, and 
visualize,” and that visualization “is the act 
of deciding what it is.” Is it a tape recorder, 
or is it a device for recording live opera, 
or is it a toy for playing tapes of tunes at 
the beach? 

Kelly considers engineering to be mere 
implementation and emphasizes that de¬ 
sign comes first, is a creative process, and 
requires a creative leap that is uncom¬ 
fortable to the engineering mind. Donald 
Schon and others in this book tell a more 


complicated story: that development is a 
spiral process of design, feedback, and 
design tweaking, some of the feedback 
coming from users, some from engineer¬ 
ing, and some, probably, from marketing. 
I say “feedback,” but Schon prefers the 
phrase “backtalk cycle,” 

“... steering slightly to the left when you 
should be moving to the right.” They were 
being told, “This product is not what you 
think it is.” Consumers were projecting onto 
the product meanings different from the in¬ 
tentions of die product designers. 

This from Schon’s enlightening discus¬ 
sion of design work on a product far from 
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computer software, but wildly success¬ 
ful—Scotch Tape. Note again the em¬ 
phasis on what the product is, but in this 
case coming from its users. 

There is No Word in American English 
for the Opposite of Ownership 

The latter part of the book moves toward 
an analysis of what sort of culture or or¬ 
ganizational structure promotes effective 
design. Michael Schrage has some kind 
things to say about the prototyping cul¬ 
ture at Apple. Don Norman, with more 
experience with the Apple culture, paints 
a different picture. Norman’s piece is pret¬ 
ty funny, although there really aren’t any 
good jokes in it. The humor comes from 
the intense wrangling and agonizing com¬ 
promises that it recounts over something 
as simple as the location of the power 
switch. 

Well, I think it’s funny. 

Schrage likes collaboration, thinks that 
prototypes are critical, and argues that the 
prototype must be community property, 
not the pet of one individual or group. In 
particular, executives have got to be clued 
in so they can understand that a prototype 
is a prototype and not a failed attempt at 
a finished product, or, worse, an actual fin¬ 
ished product. (“Looks great. Ship it!”) 

Reading between the lines of Norman’s 
war story, you get the idea that he 
wouldn’t have minded too much in this 
case if there had been a little less collab¬ 
oration and a little more doing what he 
wanted. Winograd’s ultimate take on this 
is that “an organization can do much to 
support the process and ensure success” 
or it can “impede the design process, sti¬ 
fle creativity, and damn a project to soft¬ 
ware hell....” In other words, the book 
falls a little short of identifying what kinds 
and policies of organizations promote ef¬ 
fective design. Ah well, if the book had 
all the answers, why would we need aca¬ 
demic programs in software design? 

Which we certainly do. Bad software de¬ 
sign, as Sarah Kuhn points out, can have 
really bad coasequences in the workplace: 
unnecessary job displacement, reduction of 
skills, loss of work autonomy and control. 
Even the placement of that Macintosh pow¬ 
er switch can have life-and-death conse¬ 
quences, if it leads people to think that all 
power has l^een removed from the machine 
when it hasn’t. Software design matters. 

Paradigms Past 

One reader writes to suggest that, since 
I’ve recently covered Forth-related lan¬ 
guages in this column, I not overlook 
PostScript. Fair enough, but while I have 
written about Forth-related languages, I 
haven’t done justice to Forth itself, and 
have said nothing about its remarkable 
creator, Chuck Moore. That first, then. 
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Forth, it needs to be said at the outset, 
is a great success. True, you probably 
don’t use it, and very little commercial 
shrink-wrapped software or in-house soft¬ 
ware or shareware is written in Forth, and 
there aren’t a lot of schools teaching Forth, 
and there aren’t many books coming out 
on Forth, and you don’t see much (any?) 
Forth code in magazines like this. Forth 
was created by Charles H. “Chuck” Moore. 
It’s really Chuck’s language, as few lan¬ 
guages are one author’s. That fact is, with¬ 
out question, the secret of its success, and, 
probably, the cause of its obscurity. 

The chief insight 
from the Liddle 
piece is his 
emphasis on the 
importance of the 
user's conceptual 
model 


Forth is a success, first, because it met 
its design goals. Chuck has always thought 
of himself as an application programmer, 
and he wrote Forth to let him produce 
better applications faster, to “decrease the 
effort required and increase the quality 
produced.” When the designer is the cus¬ 
tomer there may be some bias in the eval¬ 
uation of the product, but Chuck has al¬ 
ways seemed satisfied with Forth. Okay, 
not satisfied, exactly, since he rewrote it 
many times. Happy, though. 

Forth has also succeeded in the em¬ 
bedded-systems world. The Open Boot 
programmable monitor on all SPARC 
workstations is written in Forth. And 
Chuck has spent years designing Forth 
chips of one sort or another for custom 
applications. 

What made the development of Forth 
different from that of any other language 
was the total control the designer had over 
the language, and over the taiget machine 
through the language. Forth was designed 
in part in reaction against increasing soft¬ 
ware specialization and what Chuck saw 
a Tower of Babel of languages, all serv¬ 
ing to insulate the application program¬ 
mer from the machine. In Forth, Chuck 
created a language to replace the whole 
tower: assembler, operating system, com¬ 
piler, the works. Forth slashed through 


this stack of tools and let the programmer 
work directly with the machine while do¬ 
ing high-level application programming. 

“The programmer” in the early days (the 
1970s) meant Chuck. He was his own mar¬ 
ket at first, and this gave him the freedom 
to radically redefine elements of the lan¬ 
guage on a daily basis. He did so ac¬ 
cording to his practical needs in develop¬ 
ing applications, and also according to a 
philosophy. It was pretty much a one-prin¬ 
ciple philosophy: Keep It Simple! 

He followed this principle to a degree 
that few could, or would, consider. The 
principle led to a corollary that seems 
heretical: Don’t create a library of standard 
subroutines; let programmers write their 
own. Another corollary: Don’t add features 
that might be useful. “The things you might 
want to do are infinite.... If you need an 
extension later you can code it later.” 

Forth became a model of conceptual 
economy. 

It became one of the most efficient de¬ 
velopment tools ever created. And it was 
designed, like the Apple I motherboard, 
by a designer/engineer who solicited no 
feedback from users and designed exact¬ 
ly the product that he himself wanted. 

I wonder if that approach Ls being taught 
in any of the Software Design curricula. 

Forth Fanaticism 

Nothing keeps an enterprise alive and 
healthy like a passionate and knowl¬ 
edgeable and actively involved champi¬ 
on. Chuck Moore has always been that. 
Here he is in a letter to the Forth publi¬ 
cation Forth Dimensions (Vol. 3 No. 1, 
1983), defending a particular practice of 
Forth Inc., that of storing names as three 
characters plus a character count: 

DEA- EDI— 

I AM AFR— THA- THE LET— IN THE 
LAS- ISS- ABO- FOR- INC- USI- ONL- 
THR- LET— NAM- FIE— HAS HAD THE 

OPP-EFF— FRO- WHA- THE WRI— 

WAN- 

HIS LET— ( LIK- THI- ONE ) SHO- 
THA- SAV— ONL- THR- LET— AND 
COU- IS JUS- ABO- OPT— IN TER- 
OF A TRA- OFF BET— SAV- MEM— 

AND KEE— LEG- 

WE STI- DON- SEE THE NEE- FOR 

31 CHA-NAM- IN THE GEN— CAS- 

YOU- TRU- 
CHU- MOO- 
FOR- INC- 

That issue of Forth Dimensions was ac¬ 
tually on the aforementioned knuckle¬ 
head’s desk when he was planning that 
software-design column. It’s a wonder it 
didn’t come out as “The Sof-— Des—.” 

Til- nex- tim- 

Mik- Swa— 
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C PROGRAMMING 


Wanted: Senior C++ 
Programmer 


Al Stevens 

G ood morning, Mr. Phelps. The title 
of this month’s column is a typical 
entry taken from the help-wanted 
section of the local classified ads. 
Does it get your attention? Add your ad¬ 
dress and phone number to the ad, pub¬ 
lish it in your local paper, and, depending 
on where you live, you will get lots of calls 
and mail. Headhunters will deluge you with 
resumes, every one of which has the to¬ 
ken C++ somewhere near the top of die 
first page. Programmers who want to reap 
die harvest of the C++ demand will polish 
up dieir resumes to emphasize their C++ 
exposure and send diem in. 

Your mission, should you choose to ac¬ 
cept it, is to find the best applicant, the 
one capable of filling the senior C++ pro¬ 
gramming posidon, from among die many. 

Last mondi, I listed some questions that 
you can ask people who apply for a C++ 
programming job. This month I’ll discuss 
what I think are good answers to those 
questions. I’m writing this column in June, 
and the August issue is not on the street 
yet, so, although I asked for your com¬ 
ments, you haven’t had that opportunity. 
Once again, this technique is my own de¬ 
vice, is influenced by my opinions, and 
needs polish. I’m eager to hear all com¬ 
ments and criticisms. 

The questions are in three categories: 

• The first category probes whether appli¬ 
cants have a rudimentary understanding 
of the differences between C and C++. 

• The second category examines their 
grasp of class design. 

• The diird detemiines how well diey have 
kept abreast of language changes that 
the ANSI committee has proposed and 
approved. 

I developed this technique after watch¬ 
ing a client conduct interviews of many 
applicants for a single position. It became 
obvious diat diere was no structure to the 
art of the interview. The interviewer un¬ 
derstood the problems of the project, but 
she is not a C++ programmer. Conse¬ 
quently, her technical questions were su¬ 
perficial (“Have you ever programmed 
with OWL? ”, for example) and the answers 
revealed nothing important about the ap¬ 
plicant’s abilities. When she asked me to 


help, I realized after a couple of interviews 
that my extemporaneous style needed let¬ 
ter organization. I needed a plan. This set 
of questions is the result. 

The first question you should ask Ls if the 
applicant Ls a devoted reader of this column. 
If so, you’re on your own. The programmer 
has probably read and memorized these an¬ 
swers by now. Hire ’em. Readers of this col¬ 
umn are always a good bet, I lxt. 

After that, the questions you ask are de- 
temiined by how applicants represent their 
knowledge and experience. Anyone who 
really wants the job tries to match aspects 
of their experience with an interviewer’s 
questions. It’s a natural tendency. 

There is an art to resume writing, too, 
that emphasizes work experiences to fit 
the job requirements no matter how triv¬ 
ial the experience was. Some headhunters 
are really good at it. Therefore, don’t de¬ 
pend on the details of a resume to prop¬ 
erly identify an applicant’s abilities. But 
you do need to make that determination 
because if you ask too many questions 
that are beyond the scope of a program¬ 
mer’s knowledge, the interview deterio¬ 
rates into a confrontation, and the appli¬ 
cant stops wanting to work for you. 
Consequently, the first three questions are 
designed to reveal how applicants want 
their skills to be regarded and should per¬ 
mit you to follow with the appropriate 
questions chosen from the three groups. 

Questions to Qualify an Applicant 

Q: Do you have a basic understanding of 
C and C++ and their similarities and 
differences? 

A: Yes. 

If the answer Ls “yes,” proceed and plan 
to ask all the questions in the first group. If 
not, tlie interview for a C++ programmer’s 
job should lx over, and you should lx talk¬ 
ing about other employment opportunities. 

Q: Have you participated in the design of 
C++ classes to support an application’s 
problem domain? 

A: Yes or No. 

If the answer is “yes,” plan to include the 
questions in the second group. Applicants 
usually want to describe the details of the 



systems they have designed. Pay attention 
if you understand the nature of the appli¬ 
cation. If not, pretend to pay attention. If 
they have not actually done any class de¬ 
sign, ask if they think they understand it. If 
so, include the second set of questions. 

Q: Do you keep up with what the ANSI 

C++ Standards committee is doing? 

A: Yes or No. 

Most people do not. Few people have 
the time. But occasionally there is that rare 
soul who reads all the magazines and 
books, owns a copy of the draft standard, 
and regularly tracks the C++ news groups 
on the net. If an applicant claims to be 
one of them, include the third group of 
questions in your interrogation. 

The Art of the Interview 

With your applicants qualified as to how 
they represent themselves, ask the ques¬ 
tions from the chosen tliree groups. Mix the 
questions and keep a light but detached at¬ 
titude going if you can. As soon as you get 
into details, many people tighten up. They 
know they are being tested, and as they try 
to interpret the question to figure out what 
you want to hear, sometimes they lose sight 
of the objective, which is to expose what 
they know rather than what their intuition 
tells them is an acceptable answer. 

Maintain your detachment. Be cordial, 
but don’t get chummy just yet. Remember, 
if you hire this person to work with you 
on your typically understaffed, under- 
budget, overdue C++ programming pro¬ 
ject, the two of you are going to spend a 
lot of tense moments together. Observe 
how the applicant handles the pressure of 
the interview. If your shop is typical, the 
two of you will have to routinely deal with 
a lot more pressure than this. 

Don’t expect everyone to get everything 
right (unless they read this column, of 
course, and fiblxd alxxit die first question). 

Questions for All Applicants 

Here’s die first group of questions and my 
opinions about what some acceptable 
answers would lx. These quesdons do not 
cover C++ wall-to-wall, of course. I select¬ 
ed them as typical of die kind of knowl¬ 
edge that all C++ programmers should be 
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(continued from page 92) 
expected to possess. There are five ques¬ 
tions. Three correct answers is a good score. 

Q: How do you link a C++ program to C 
functions? 

A: By using the extern “C” linkage speci¬ 
fication around the C function decla¬ 
rations. 

Programmers should know about man¬ 
gled function names and type-safe linkages. 
Then they should explain how the extern 
“C" linkage specification statement turns 
that feature off during compilation so that 
the linker properly links function calls to C 
functions. Another acceptable answer is “I 
don’t know. We never liad to do that.” Mere¬ 
ly describing what a linker does indicates 
that the programmer does not understand 
the issue that underlies the question. 

Q: Explain the scope resolution operator. 
A: It permits a program to reference an 
identifier in the global scope that has 
been hidden by another identifier with 
the same name in the local scope. 

The answer can get complicated. How¬ 
ever, it should start with If the pro¬ 
grammer is well into the design or use of 


classes that employ inheritance you might 
hear a lot about overriding member func¬ 
tion overrides to explicitly call a function 
higher in the hierarchy. That’s good to 
know, but ask specifically about global 
scope resolution. You’re looking for a de¬ 
scription of C++’s ability to override the 
particular C behavior where identifiers in 
die global scope are always liidden by like 
identifiers in a local scope. 

Q: What are the differences between a C++ 
struct and C++ class? 

A: The default member and base-class 
access specifiers are different. 

This is one of the commonly misun¬ 
derstood aspects of C++. Believe it or not, 
many programmers think that a C++ 
stmet is just like a C struct , while a C++ 
class has inheritance, access specifiers, 
member functions, overloaded operators, 
and so on. Some of them have even writ¬ 
ten books about C++. Actually, the C++ 
struct has all the features of the class. 
The only differences are that a stmet de¬ 
faults to public member access and pub¬ 
lic base-class inheritance, and a class de¬ 
faults to the private access specifier and 
private base-class inheritance. Getting 
this question wrong does not necessari- 
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ly disqualify an applicant. Getting it right 
is a definite plus. 

Saying, “I don’t know” is definitely the 
wrong answer. I advance an unusual po¬ 
sition about this. C++ programmers should 
at least believe that they know the differ¬ 
ences, even when they are wrong about 
them. Getting it wrong is, therefore, right. 
You can explain the true difference in the 
interview and advance the programmer’s 
knowledge. If they disagree vociferously, 
you have an opportunity to observe how 
they handle contentious debate when they 
are wrong and don’t know it yet. 

Q: How many ways are there to initialize 
an int with a constant? 

A: Two. 

There are two formats for initializers in 
C++ as shown in the example that follows. 
The first format uses the traditional C no¬ 
tation. The second format uses construc¬ 
tor notation. 

int foo = 123; 
int bar (123); 

It’s acceptable when a programmer does 
not know about the second notation, al¬ 
though they should certainly know about 
the first one. Many old-timer C program¬ 
mers who made the switch to C++ never 
use the second idiom, although some wise 
heads of C++ profess to prefer it. If your 
applicant is quick with the right answer, 
that’s a good sign. 

Q: How does throwing and catching ex¬ 
ceptions differ from using setjmp and 
longjmp ? 

A: The throw operation calls the destruc¬ 
tors for automatic objects instantiated 
since entry to the try block. 

Exceptions are in the mainstream of C++ 
now, so most programmers, if they are fa¬ 
miliar with setjmp and longjmp , should 
know the difference. Both idioms return 
a program from die nested depdis of mul¬ 
tiple function calls to a defined position 
higher in die program. The program stack 
is “unwound” so diat the state of the pro¬ 
gram, with respect to function calls and 
pushed arguments, is restored as if the calls 
liad not been made. C++ exception han¬ 
dling adds to diat liehavior die orderly calls 
to the destructors of automatic objects that 
were instantiated as the program pro¬ 
ceeded from within die tty block toward 
where the throw expression is evaluated. 

Applicants might think you want to 
hear about the notational differences be¬ 
tween the two idioms. Let them proceed 
to explain the syntax of try> blocks, catch 
exception handlers, and throw expres¬ 
sions. Then ask them specifically what 
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(continued from page 94) 
happens in a throw that does not happen 
in a longjmp. Their answer should reflect 
an understanding of the behavior de¬ 
scribed in the previous answer. 

One valid reason for not knowing about 
exception handling is that the applicant’s 
experience is exclusively with older C++ 
compilers that do not implement exception 
handling. I would prefer that they have at 
least heard of exception handling, though. 
Another marginally acceptable reason is diat 
their fonner supervisors and designers did 
not mandate and specify the use of excep¬ 
tion handling in programs. In that case get 
the names of those supervisors and de¬ 
signers so that you can decline their appli¬ 
cations if they should come a’knocking. 

It is not unusual for C and C++ pro¬ 
grammers to be unfamiliar with setjmp/ 
longjmp . Those constructs are not partic¬ 
ularly intuitive. A C programmer who has 
written recursive descent parsing algo¬ 
rithms will certainly be familiar with 
setjmp/longjmp. Others might not, and 
that’s acceptable. In that case, they won’t 
be able to discuss how setjmp/longjmp 
differs from C++ exception handling, but 
let the interview turn into a discussion of 
C++ exception handling in general. That 
conversation will reveal a lot about a pro¬ 
grammer’s understanding of C++. 


Questions for Class Designers 

The second group of questions explores 
die applicant’s knowledge of class design. 
There are eight questions. Five out of eight 
is a good score. 

Q: What Is your reaction to diis line of code? 

delete this; 

A: It’s not a good practice. 

Many applicants will look at you like 
you are nuts. They’ve never heard of this 
usage, and it’s never occurred to them. 
That’s a very good answer. Perhaps they 
will try to explain die behavior of die state¬ 
ment. Ask them to contemplate its con¬ 
sequences. Two quite acceptable reactions 
are, “Don’t do it,” and “Don’t do it unless 
you really know what you are doing and 
you are a masochist.” 

A good programmer will insist that you 
should absolutely never use the statement 
if the class is to be used by other pro¬ 
grammers and instantiated as static, ex¬ 
tern, or automatic objects. That much 
should be obvious. 

The code has two built-in pitfalls. First, 
if it executes in a member function for an 
extern, static, or automatic object, the pro¬ 
gram will probably crash as soon as the 


delete statement executes. There is no 
portable way for an object to tell that it 
was instantiated on die heap, so die class 
cannot assert diat its object is properly in¬ 
stantiated. Second, when an object com¬ 
mits suicide this way, die using program 
might not know about its demise. As far 
as the instantiating program is concerned, 
the object remains in scope and continues 
to exist even diough the object did itself 
in. Subsequent dereferencing of die point¬ 
er can and usually does lead to disaster. I 
think that the language rules should dis¬ 
allow the idiom, but that’s anodier matter. 

In More Effective C++ (Addison-Wesley, 
1996), Scott Meyers devotes one of his 
items to “ delete this,” implying that diere 
are valid applications for the idiom and 
advancing contrived code kludges to make 
it seem to work better. A programmer who 
has read this otherwise very good book 
might diink that die practice is acceptable. 
Experience leads me to disagree. 

Q: What is a default constructor? 

A: A constructor that has no arguments. 

If you don’t code one, die compiler pro¬ 
vides one if there are no other constmc- 
tors. If you are going to instantiate an ar¬ 
ray of objects of the class, the class must 
have a default constaictor. 
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Q: What is a conversion constaictor? 

A: A constaictor that accepts one argu¬ 
ment of a different type. 

The compiler uses this idiom as one 
way to infer conversion rules for your 
class. A constaictor with more than one 
argument and with default argument val¬ 
ues can be interpreted by die compiler as 
a conversion constaictor when the com¬ 
piler is looking for an object of your con¬ 
structor’s type and sees an object of the 
type of die constructor’s first argument. 

Q: What is the difference between a copy 
constaictor and an overloaded assign¬ 
ment operator? 

A: A copy constructor constructs a new 
object by using the content of the ar¬ 
gument object. An overloaded assign¬ 
ment operator assigns the contents of 
an existing object to another existing 
object of the same class. 

First, die applicant must know that a copy 
constaictor is one that has only one argu¬ 
ment of die same type as the constaictor. 
The compiler invokes a copy constaictor 
wherever it needs to make a copy of the 
object, for example to pass an argument by 
value. If you do not provide a copy con¬ 
staictor, the compiler creates a member- 
by-manlier copy constructor for you. 

You can write ovedqaded assignment 
operators that take arguments of other 
classes, but that behavior is usually im¬ 
plemented with implicit conversion con- 
structors. If you do not provide an over¬ 
loaded assignment operator for the class, 
the compiler creates a default member- 
by-member assignment operator. 

This discussion Is a good place to get 
into why classes need copy constructors 
and overloaded assignment operators. If die 
applicant discusses these with respect to 
data member pointers that point to dy¬ 
namically allocated resources, die applicant 
probably has a good grasp of the problem. 

Q: When should you use multiple inher¬ 
itance? 

A: There are three acceptable answers: 
“Never,” “Rarely,” and “When the prob¬ 
lem domain cannot lie accurately mod¬ 
eled any other way.” 

There are some famous C++ pundits 
and luminaries who disagree with that 
third answer, but I will accept it. 

Let’s digress to consider this issue lest 
your interview turn into a religious debate. 
Consider an Asset class, Building class, 
Vehicle class, and CompanyCar class. All 
company cars are vehicles. Some compa¬ 
ny cars are assets because the organiza¬ 
tions own them. Others might lie leased. 
Not all assets are vehicles. Money accounts 


are assets. Real estate holdings are assets. 
Some real estate holdings are buildings. Not 
all buildings are assets. Ad infinitum. When 
you diagram these relationships, it Incomes 
apparent that multiple inheritance is a like¬ 
ly and intuitive way to model this com¬ 
mon problem domain. The applicant 
should understand, however, that multi¬ 
ple inheritance, like a chainsaw, is a use¬ 
ful tool that has its perils, needs respect, 
and is best avoided except when noth¬ 
ing else will do. 

Q: What is a virtual destructor? 

A: The simple answer is that a virtual de¬ 
structor is one that is declared with the 
virtual attribute. 

The behavior of a virtual destructor is 
what is important. If you destroy an ob¬ 
ject through a pointer or reference to a 
base class, and the base-class destructor 
is not virtual, the derived-class destructors 
are not executed, and the destruction 
might not be complete. 

Q: Explain the ISA and HASA class rela¬ 
tionships. How would you implement 
each in a class design? 

A: A specialized class “is” a specialization 
of another class and, therefore, has 


the ISA relationship with the other 
class. An Employee ISA Verson. This 
relationship is best implemented with 
inheritance. Employee is derived from 
Person. A class may have an instance 
of another class. For example, an em¬ 
ployee “has” a salary, therefore the 
Employee class has the HASA rela¬ 
tionship with the Salcny class. This re¬ 
lationship is best implemented by em¬ 
bedding an object of the Salcny class 
in the Employee class. 

The answer to this question reveals 
whether the applicant has an under¬ 
standing of the fundamentals of object- 
oriented design, which is important to re¬ 
liable class design. 

There are other relationships. The 
USES A relationship is when one class uses 
the services of another. The Employee class 
uses an object ( coat) of the ostream class 
to display the employee’s name on the 
screen, for example. But if the applicant 
gets ISA and HASA right, you don’t need 
to go any further. 

Q: When is a template a better solution 
than a base class? 

A: When you are designing a generic class 
to contain or otherwise manage objects 
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of other types, when the format and 
l^ehavior of those other types are unim¬ 
portant to their containment or man¬ 
agement, and particularly when those 
other types are unknown (thus, the 
genericity) to the designer of the con¬ 
tainer or manager class. 

Prior to templates, you had to use in¬ 
heritance; your design might include a 
generic List container class and an appli¬ 
cation-specific Employee class. To put em¬ 
ployees in a list, a ListedEmployee class is 
multiply derived (contrived) from the Em¬ 
ployee and List classes. These solutions 
were unwieldy and error-prone. Templates 
solved that problem. 

Questions for ANSI-Knowledgeable 
Applicants 

There are six questions for those who 
profess knowledge of the progress of the 
ANSI committee. If you claim to have 
that much interest in the language, you 
should know the answers to all these 
questions. 

Q: What is a mutable member? 

A: One that can be modified by the class 
even when the object of the class or 
the member function doing the modi¬ 
fication is const. 


Understanding this requirement implies 
an understanding of C++ const, which many 
programmers do not have. I have seen laige 
class designs that do not employ the const 
qualifier anywhere. Some of those designs 
are my own early C++ efforts. One author 
suggests that some programmers find con¬ 
st to be such a bother that it is easier to ig¬ 
nore const than to try to use it meaningful¬ 
ly. No wonder many programmers don’t 
understand the power and implications of 
const. Someone who claims to have enough 
interest in the language and its evolution to 
keep pace with the ANSI deliberations 
should not be ignorant of const , however. 

Q: What is an explicit constructor? 

A: A conversion constructor declared with 
the explicit keyword. The compiler 
does not use an explicit constructor to 
implement an implied conversion of 
types. It’s purpose is reserved explicit¬ 
ly for construction. 

Q: What is the Standard Template Library? 
A: A library of container templates approved 
by the ANSI committee for inclusion in 
the standard C++ specification. 

A programmer who then launches into 
a discussion of the generic programming 
model, iterators, allocators, algorithms, and 


such, has a higher than average under¬ 
standing of the new technology that STL 
brings to C++ programming. 

Q: Describe run-time type identification. 
A: The ability to determine at run time the 
type of an object by using die typeid op¬ 
erator or die dynamicjcast operator. 

Q: What problem does die namespace fea¬ 
ture solve? 

A: Multiple providers of libraries might use 
common global identifiers causing a 
name collision when an application tries 
to link with two or more such libraries. 
The namespace feature surrounds a li¬ 
brary’s external declarations with a 
unique namespace that eliminates the 
potential for those collisions. 

This solution assumes that two library 
vendors don’t use the same namespace 
identifier, of course. 

Q: Are there any new intrinsic (built-in) 
data types? 

A: Yes. The ANSI committee added the 
bool intrinsic type and its true and false 
value keywords. 

Other apparent new types (string, com¬ 
plex, and so on) are implemented as classes 
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in the Standard C++ Library rather than as 
intrinsic types. 

What Not to Do 

Don't ask the applicant to write a program 
on the spot. Many programmers, myself in¬ 
cluded, like to ponder a program for a while 
before writing any code. We would con¬ 
sider a one-hour deadline as a threat. We 
would be unwilling to let anyone see such 
a program. You’ll get a far better under¬ 
standing of the applicant’s programming 
skills by asking a former employer about 
the programmer’s ability to write reliable, 
extensible, maintainable, and timely code 
that fulfills the user’s requirements. 

Don’t turn these questions into a writ¬ 
ten test. Some people don’t take tests well, 
particularly when die answers involve nar¬ 
rative text. Many fine programmers are not 
articulate writers. Others simply hate tests 
and shut down mentally. 

Case in point. My pal Bill Chaney was 
the highest-time student pilot I ever met. 
Over a period of several years, he accu¬ 
mulated close to 1000 hours on his student 
pilot's license. I would have trusted Bill to 
fly one of my children anywhere in that old 
Cessna 150 of his, but he was intimidated 
by the environment of the written exami¬ 
nation and could not pass it. There’s a hap¬ 
py ending: Several of us ganged up on Bill, 


crammed him on the written exam, satu¬ 
rated him with a positive mental attitude, 
and railroaded him through passage of the 
test. Bill is a legal pilot today. 

There’s another reason to avoid the writ¬ 
ten test, one that is driven by social changes 
in our culture. Last month I said, “For some 
reason, die Labor Department doesn’t want 
you disqualifying anyone based on their in¬ 
ability to demonstrate that they can do the 
job.” Now Ill expand on that statement, and 
perhaps stir a bit of controversy. 

During my government client’s quest for 
employees, she was questioned by the lo¬ 
cal EEO representative about her testing 
practices. They were particularly concerned 
about whether she was administering, and 
specifically, grading tests. There is a strong 
belief that certain segments of our society, 
like my pal Bill Chaney, do not take tests 
well, that those segments can be identified 
by ethnic divisions, and that testing diem 
provides the potential for discrimination. 
That belief, or the fear of those who hold 
it, drives official policy. 

The EEO is not consistent in this con¬ 
cern. You can’t carry passengers in a 747 
widiout proving your experience and abil¬ 
ity and passing several of the government’s 
oral and written graded tests. You don’t get 
anywhere near my gall bladder, retirement 
account, or household wiring without a 


certificate on die wall proving that you have 
scored passing grades on a bevy of writ¬ 
ten tests. The potential to discriminate is 
overlooked when something important like 
our lives or our money is at stake. 

My parents’ generation was the last one 
that discriminated against edmic and gen¬ 
der boundaries with the sanction of law 
to back them up. (My parents didn’t do it, 
but their generation did and the law al¬ 
lowed it.) Many of my generation inherit¬ 
ed and retained that bias even when the 
sanctions were removed through legisla¬ 
tion and judicial decree. Most of the new¬ 
er generation is free of that bias, I hope, 
at least intellectually if not emotionally. 
But the swing of the pendulum is not yet 
dead center. If you administer written tests 
to programmers, grade those tests, and use 
diose grades to disqualify someone for em¬ 
ployment, you might find yourself the ob¬ 
ject of a discrimination investigation. 

So, ask those questions and take notes. 
But don’t write grades on a score sheet. 
Or, in case you do, there is a device in 
our office named “Hillary.” Get one. (It’s 
also called a shredder.) As usual, if you 
or any of your interviewers are killed or 
captured, DDJ will disavow any knowl¬ 
edge of your activities. 

DDJ 
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JAVA Q&A 


How Do I Create a Layout 
Manager? 


Cliff Berg 

W hen building a user interface for 
an application, anticipating the 
requirements for a variety of dis¬ 
plays is a common dilemma. 
User input fields and controls may look 
fine on one kind of monitor or comput¬ 
er, yet look too sparse, crowded, or oth¬ 
erwise ill-adjusted on another. Even with¬ 
in a given platform, the user always has 
the freedom to resize the application’s 
window, possibly destroying the intend¬ 
ed layout in the process. This is even 
more problematic when the application 
has to run on multiple platforms, like a 
Java program does. 

The Java user-interface toolkit, known 
as the “Abstract Window Toolkit” (AWT), 
provides a set of classes that let you build 
a resizing methodology into an applica¬ 
tion, without programming it all from 
scratch. These classes all derive from an 
interface (Java’s parlance for an abstract 
class) called LayoutManager. There are 
five predefined layout-manager imple¬ 
mentations, each with its own policies for 
laying out GUI components. You can mix 
and match these, choosing a different one 
for each control panel with the applica¬ 
tion, thereby giving each panel its own 
method of rearranging components when 
the window size changes. 

This sounds great, except that the five 
layout managers that come with the Java 
AWT are not always the ones you might 
want. For example, one of the five, Bor¬ 
derLayout , lets you arrange components 
along the four sides of the window (or 
panel), with another in the center. This is 
well-suited for the top-level window lay¬ 
out in many situations, in which die main 
application area sits in the center, with a 
title or banner of some kind at the top, 
and controls at the bottom, left, and right. 
It falls short, however, if you want to add 
more than one component along a single 
edge. To do that, you have to create an¬ 
other panel, place that on the desired 


Cliff, vice president of technology of Digi¬ 
tal Focus, can be contacted at cliffbdf@dig- 
italfocus.com. To submit questions, check 
out the Java Developer FAQ website at 
http://www. digita (focus. com/Jdq/. 


edge, and then place the components on 
the panel. While this is not difficult, the 
layout does not have to be too complex 
before one starts to think, “If only the lay¬ 
out manager did this or that....” 

Java’s extensibility makes it possible to 
create a layout manager that does exact¬ 
ly what you want. Indeed, this was in¬ 
tended, and the LayoutManager interface 
defines exactly die methods that you need 
to write to create your own customized 
layout manager. The layout manager you 
create becomes part of your application— 
it need not be incorporated into the Java 
environment. 

The most widely used layout manager 
is FlowLayout, which implements the pol¬ 
icy of placing components from left to 
right, either right justified, centered, or left 
justified, and flows them to successive 
rows if sufficient space is not available. 
However, it doesn’t let you create new 
rows via program control. It also doesn’t 
let you add space between unrelated com¬ 
ponents without having to go to the trou¬ 
ble of creating a whole separate panel 
with its own layout manager. These are 
the features that I’ll incorporate into the 
layout manager presented here. 

Before I describe this layout manager, 
first consider how a layout manager is ac¬ 
tually used. The Java AWT defines an ob¬ 
ject class called Component that represents 
a user-interface (UI) component. All UI 
elements are derived from the Component 
class. A special kind of component that 
can contain other components is known 
as a Container. The Container class de¬ 
rives from Component. Elements such as 
windows, frames, and control panels that 
may contain other components all derive 
from Container. Thus, it is the container 
that owns a collection of components, and 
the container that is ultimately responsi¬ 
ble for laying out those components. To 
accomplish this, container objects use lay¬ 
out managers, and each container object 
may have exactly one layout manager for 
deciding how to lay out its components. 
In Example 1, a new panel is created, 
which, because Panel derives from Con¬ 
tainer ; may contain other components. A 
layout manager object, of type Border- 



Layout , is created, and the panel’s layout 
manager is set to this. The panel will now 
use this BorderLayout object for helping 
it to arrange its subcomponents. Subse¬ 
quently, a button object is created and 
added to the panel. At this time, the pan¬ 
el will notify the BorderLayout object that 
a button has been added. Later, when the 
panel is resized as a result of a user ac¬ 
tion or a call to resize/), the panel will 
call upon the BorderLayout to help it de¬ 
cide where to place die button in the new¬ 
ly resized panel. 

SpaceLayout 

I’ll now present a simple layout manager 
called SpaceLayout, wliich implements pre¬ 
cisely these policies. To use it, you just 
create an instance of it within your pro¬ 
gram, just as you would with any of the 
predefined layout managers, and then call 
setLayoutO ; see Example 2(a). All layout 
managers must define the methods in Ex¬ 
ample 2(b). 

• These are the methods used by other 
classes in the AWT (in particular, die Con¬ 
tainer classes) when they need to call 
upon a layout manager to help diem place 
components—normally you do not call 
these methods directly within your code. 
Instead, you call the method Contain- 
er.addO and odier methods for the win¬ 
dow, frame, panel, or odier user-interface 
container objects that contain the com¬ 
ponents. These methods, in turn, call the 
layout-manager methods, using the lay¬ 
out manager that has been specified for 
that container. 

If you correcdy implement these meth¬ 
ods, you should have a working layout 
manager. 

Some layout managers implement a 
simple stateless policy in which die place¬ 
ment of one component can be deter¬ 
mined immediately from the location of 
the component to its left or right. In this 
case, it is not necessary for the layout 
manager to store any information about 
each component, so the methods add- 
LayoutComponentC,) and removeLayout- 
Componentf) can do nothing. The con¬ 
tainer keeps its own list of what 
components it contains, so you do not 
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have to worry that the container will for¬ 
get what UI elements it encloses. That is 
not the job of the layout manager— it 
only implements policies for layout. It 
does not define the structure of the UI, 
or the component hierarchy. 

Some layout managers, like Grid- 
BcigLayout and SpaceLayout, allow you to 
define parameters or constraints for each 
component to be laid out. These con- 


Panel p = new Panel(); 
bl = new BorderLayout(); 
p.setLayout(bl); 

Button b = new Button(); 
p.add("Center”, b); 


Example 1: Creating a new panel. 


straints need to be maintained in a list or 
persistent structure that relates them back 
to the actual components. SpaceLayout 
uses a hash table for this purpose: the 
class java. util.Hashtable. The method aclcl- 
LayoutComponent(X which is called by a 
Container object automatically when a 
component is added to that container, has 
the main job of creating a constraint at¬ 
tribute object for the component being 
added, and associates the constraint with 
the component via the hash table. 

Note that there are two variations of the 
Container.addQ method. One takes a sin¬ 
gle parameter (the component to add), and 
the other takes a string and the component 
to add. The second form calls LayoulMan- 
ager.addLayoutComponent( ), whereas the 
first form skips this step, under the ques¬ 


tionable assumption that programmers us¬ 
ing this form are using simple stateless lay¬ 
out managers. This is a potential source of 
Java programming bugs. You should there¬ 
fore always use the Component.add(Suing 
Component) method rather than the Com¬ 
ponent.add(Component) mediod, even if 
you have to make up a string value or sim¬ 
ply give it a null string. 

The method SpaceLayout. setCon- 
straints() allows you to define constraints 
for a component. For example, setCon- 
straints(Constraints.LEFT ) Constraints. TOP, 
false, 10, 5, button A); specifies that but- 
tonA will be left- and top-aligned within 
the space allocated for it; it will be ten 
pixels from the next component’s space 
(which may have its own spacing re¬ 
quirement), and five pixels from the com¬ 
ponents above it. You can now set 
constraints for the buttonB button: set- 
ConstraintsOConstraints.LEFT, Constraints 
.TOP, true, 10, 5, buttonB);. The Boolean 
value of true indicates that you want this 
to be the last component in its row, and 
that the next component after it should 
be placed on the next row. 

There is a Catch-22 in that to place die 
components successfully, you first have 
to know the size of each; the placement 
of one component may affect die others. 
Yet, once you discover the component 


(a) SpaceLayout s = new SpaceLayout(); 
setLayout(s); 


(b) addLayoutComponent(String name, Component comp) 
removeLayoutComponent(Component comp) 
minimumLayoutSize(Container target) 
preferredLayoutSize(Container target) 
layoutContainer(Container target) 


Example 2: (a) Calling setLayoutO; all layout managers must define these 
methods. 
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and utilities, and several popular 
pplication packages. There are 
£ver 575 Mbytes of source, 
aries, and documentation. 

e the details of a real 
opiating system. Plan for the 
chnologies like clustering, 
cessing, and network 

Continu\ your education and 
see the future of operating 
systems. ..t\day! 
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World Wide Web 
Toolkit CD-ROM 

^The ultimate collection 
of software resources for 
the World Wide Web 

The World Wide Web Toolkit 
CD-ROM is the most comprehen¬ 
sive compendium of software 
resources relating to all aspects 
of the World Wide Web. 

Included on this CD-ROM: 

• Web Browsers 

• Web Servers 

• HTML Authoring Tools 

• Graphic Conversion Utilities 

• Search Engines 
Plus Much More! 

Contains tools for all the major 
platforms used for the Web 
today including Unix, 16 & 32 bit 
Windows, Macintosh and OS/2. 
Most tools come with complete 
source code for C, C++ or Perl. 

Use your own Web Browser to 
locate and download the tools 
and applications directly from 
the CD-ROM. 

Save time and trouble — avoid 
hours of on-line time! 


Price: $29.95 


800 - 992-0549 

Fax Orders 

913-841-2624 

E-Mail Orders 

orders@mfi.com 

Mail Orders 

Dr. Dobb's CD-ROM Library 

International 

1601 West 23rd St. f Ste. 200 
Lawrence, KS 66046-2700 USA 
Use Mail, Fax, E-Mail 


Or Call 913-841-1631 




























Your comprehensive imaging solution 


Scanning Color Conversion Displaying Annotation Processing File Formats Compression Printing 


ALL NEW LEADTOOLS 6 We've 
included everything you need to support raster images 
in your application: from B&W document imaging, to 
grayscale medical imaging, to 16 color through 16 
million color desktop imaging. Whatever imaging 
application you or your customer needs, 
LEADTOOLS 6 is the solution. Our toolkit delivers 
over 150 functions to read, write, compress, image 
process, display, print, scan, scroll, zoom, dither & 
more. New features include annotation, region 
processing, and support for several new file formats. 
With the new internal 

can select the components you need for your specific 
development scenario. This new feature allows you to 
keep the size of your application to a minimum. 
LEADTOOLS 6 is the source for complete imaging. 
Scanning Supports 16 & 32 bit TWAIN 
interfaces for driving the most popular scanning 
devices. 

Color Conversion Expand or reduce an 
image’s color depth with multiple dithering methods 
using customized or optimized palettes. Separate an 
image into individual RGB, CMYK, CMY, HSV, and 
HSL color planes. You can even reconstruct the 
original image from the separated planes. 
LEADTOOLS also supports grayscale conversion and 
halftoning with rotated screens. 

Display Optimized rendering of any image to all 
display devices with auto-dithering and scaling. The 
fixed palette option will 
eliminate the palette shift 
nightmare of a 256 color 
device, yet will maintain the 
best image quality. Easy to use 
ultra fast paint, zoom, scroll, 
crop, and pan will make your 
application fly. The optimum 
256 shades of scale to gray 
(interpolated) or favor black 
viewing options will enhance 
the quality and readability of 
the display of one bit 
document images. 


Processing 

Get a vast array of 
image processing 
functions including 
resize, interpolated 
resize, rotate (.01°), 
flip, invert, reverse, 
crop, transpose, fill, 
sharpen, blur, 
brighten, darken, 
hue & saturation, 
intensity detect, 
stretch intensity, 
contrast, gamma 
correct, histogram 
equalize, edge 
detect, line detect, 
mosaic, shear, 
posterized, median 
& noise filter, 
spatial filter 
(gradient, laplacian, 
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Formats 


BMP 

IMG 

MSP 

TGA 

CAL 

I0CA 

PCD 

TIFF 

DIB 

JPEG 

PCT 

VDA 

EPS 

JFIF 

PCX 

VST 

FAX (raw) 

JTIF 

PNG 

WINFAX 

DCX 

LEAD CMP 

PSD 

WMF 

GIF* 

MAC 

RAS 

WPG 


Partial list, full dotails at our new Web site. 


sobel, prewitt, shift &. difference, line segment), 
underlay, region processing &. more. Features like 
auto deskew and despcckle are perfect for document 
image clean-up before running an OCR routine to an 
image. You can even use Windows GDI functions to 
draw directly to a bitmap. 

File Formats LEADTOOLS 6 provides 
support for most popular raster image formats 

(including practically all known 
“flavors”) at different pixel 
depths and compression 
options. See a full list at 
http://www/leadtools.com/ 
Compression No other 
toolkit offers as many 
compression options including 
CCITT G3 & G4, 

CompuServe’s new lossless 
PNG, JPEG and LEAD’S own 
proprietary CMP. LEADTOOLS 
delivers the fastest software 


Printing LEADTOOLS 6 performs all the image 
processing necessary to print to any printer with the 
highest quality and has the capability to print text and 
multiple images on the same page. 
LEADTOOLS is offered as an OCX (16 & 32 
bit), a VBX, a DLL (WIN 16 & WIN32), and a DLL 
for OS/2. LEAD’s mature code is backed up by a thirty 
day money back guarantee and FREE technical 
support via phone, fax, BBS, Internet, or 
CompuServe. LEADTOOLS saves you time by 
providing numerous source code examples you can 
paste directly into your application. If you need 
imaging, you need LEADTOOLS. 


“We use LEAD’s imaging technology in our WinFax 
Scanner and CommSuite 95 products. It's complete, 
fast and gets the job done." 


- Bert Amato, Vice President, Delrina Group, Symantec. 


Annotation Add annotations to both B&W 
documents and color images. Write text, highlights, 
sticky notes, red-line, free hand scribble, blackout, etc. 


only JPEG algorithms. The CMP format results in 
smaller file sizes and maintains better image quality 
than industry standard compression formats. 


“LEADTOOLS does image manipulation 
and does it right!" 


- BYTE Magazine February, 1995 


Download FREE 
imaging application built with 
NEW LEADTOOLS 6! 
or call 

800-637-1837 


Everything You Need To Know About Imaging 


http://www.leadtools.com/ 
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VISUAL BASIC 
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PARADOX 1 



ACCESS I DELPHI I VISUAL FOXPRO 


900 Boxter St. Charlotte, NC 28204 704-332-5532 Fax:704-372-8161 CompuServe:'GO LEADTECH' 
LEADTOOLS n available in several versions, not all features are available in all versions. 
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ALGORITHM ALLEY 


HATs: Hashed 
Array Trees 

Fast variable-length 
arrays 

Edward Sitarski 



A rrays are die most natural and con¬ 
venient data structure for a great 
many applications. They provide 
constant access time to their ele¬ 
ments and are die structure of choice for 
many practical algorithms. Most commer¬ 
cial C++ toolkits offer a variable-length 
array container class, and probably mil¬ 
lions of C++ programs use variable-length 
arrays as their core data structures. In¬ 
creasing die size of a variable-length ar¬ 
ray by appending to die end is a common 
operation; if we knew the size of the ar¬ 
ray at the start then there would be no 
reason to use a variable-lengdi array. 

I became painfully aware of the limita¬ 
tions of most implementations of variable- 
length arrays when investigating some 
code that read the results of a database 
query. There was no way to determine 
the number of rows returned from the 
query beforehand, and the code used a 
commercial variable-length array class to 
store the data. The profiler told me that 
the array class was doing an incredible 
amount of element copying when resiz¬ 
ing. This copying was taking much more 
time than the slow data transfer from the 
database! 

You might argue that another data struc¬ 
ture, such as a linked list, would have been 
more appropriate for this application, but 
it was too difficult to fix all the old code. 

I decided to try to implement a better per¬ 
forming array class that had the same in¬ 
terface as the old one. 


Edward is vice president of R&D at Nu- 
metrix Ltd. He can be reached at ed@ 
tor numetrix. com. 


Many implementations of variable- 
length arrays leave much to be desired. 
Specifically, the function that appends to 
die end of die array can cause a large per¬ 
formance problem. Example 1 shows just 
about the worst way to do it. There are 
two main reasons why this implementa¬ 
tion is so bad. 

• Excessive element copying. If you add 
1000 elements to the array, die internal 
loop will copy the old elements into 
neivTAiray each time the array expands, 
a total of over 500,000 copy operations. 
This seemingly innocent code is doing 
about 500 times more assignments than 
necessary for the 1000 elements, and it 
only gets worse as die array grows. This 
implementation is 0(N 2 ) (die same time 
complexity as Bubblesort) and highly 
inefficient even for small arrays. 

• Excessive memory usage. During the 
copy operation, both the existing array 
and the new array must be present in 
memory at die same time, doubling the 
memory requirement of die array. Worse, 
each time the array grows, it creates a 
memory fragment: die old array. Tliis frag¬ 
ment cannot be reused die next time the 
array grows because die new array Ls hug¬ 
er and will not fit, as shown in Figure 1. 
This can increase the memory require¬ 
ments by almost anodier factor of two. 

It is interesting to note diat C’s reallocO 
function does not have such severe prob¬ 
lems. The reason is diat once die array is 
large enough, it will be allocated from die 
end of the heap, realloc can dien expand 
the buffer by increasing the size of the 


memory block widiout having to copy the 
data. Unfortunately, diis does not work widi 
C++ because realloc cannot call construc¬ 
tors on the expanded memory. C++ re¬ 
quires us to copy the elements explicitly. 

You might try to address these prob¬ 
lems by growing the array by more than 
one element at a time. However, this does 
not significantly reduce the memory us¬ 
age. Even diough it reduces die total num¬ 
ber of copies, it is still an 0(/V 2 ) algo¬ 
rithm— all you’ve done is decrease the 
ainning constant. For example, if you add 
1000 elements and grow the array by 10 
elements whenever it’s full, you are still 
performing 10+20+..+1000 = 50,500 copy 
operations, which is still 0(N 2 ). Although 
this is 10 times less copying than before, 
it is still 50 times more copying than is 
necessary. 

HATs Usually Append in 0( 1 ) Time 

To overcome the limitations of variable- 
length arrays, I created a data structure 
diat has fast constant access time like an 
array, but mosdy avoids copying elements 
when it grows. I call this new structure a 
“Hashed-Array Tree” (HAT) because it 
combines some of die features of hash ta¬ 
bles, arrays, and trees. 

Although used to implement one¬ 
dimensional arrays, HATs are really two- 
dimensional; see Figure 2. A HAT consists 
of a Top array and a number of Leavr 
which are pointed to by the Top ? 

The number of pointers in the ^ 
and the number of elements ' 
is die same, and is alwa’ 

Because the Top z\ 
powers of 2, you can e. 


Dr. Dobb’sJournal, September 1996 




element in a HAT using bit operations; see 
Example 2. Usually, appending elements 
is very fast since the last leaf may have 
empty space. Less frequently, you’ll need 
to add a new leaf, which is also very fast 
and requires no copying. 

When die Top array is full, it becomes 
a bit more interesting. My implementation 
first computes the correct size ( Top and 
Leaf arrays are the same size, both a pow¬ 
er of 2), then copies the elements into a 


new HAT structure, freeing the old leaves 
and allocating new leaves as it goes. 

This approach dramatically avoids most 
of the element copying performed by the 
previous array implementation. Recopy¬ 
ing only occurs when die Top array is full, 
and this only happens when the number 
of elements jusrt exceeds the square of a 
power of 2. If N=4 n , dien the total amount 
of recopying is 1+ 4+16+ 64+256+... +N. 
Using the identity (x (,,+1) - l)=(x-l) 


(l+x+x 2 +x3 +... + x n ) you have 1 
+4+42+ 43+ +411 = (4(n+i)_2)/(4-j) = 

(4N-1)/3 , or about 4/3 N. This means 
that the average number of extra copy op¬ 
erations is O(A0 for sequentially append¬ 
ing N elements, not 0(N 2 \ 

The technique of reallocating and copy¬ 
ing each leaf one at a time also signifi¬ 
cantly reduces die memory overhead. In¬ 
stead of needing memory for a complete 
copy of the HAT, you only need enough 
memory for an extra leaf. Because die leaf 
size depends on the square root of N, the 
extra memory required during resizing de¬ 
creases dramatically as a percentage of N. 
For example, if you added 1,000,000 ele¬ 
ments to die HAT, the extra memory need¬ 
ed for the last resize would be 1024 ele¬ 
ments or about 0.1 percent of die memory 
already used for the array’s data. 

In addition, memory fragmentation is 
reduced. Since the Top and Leaf sizes al¬ 
ways increase to the next power of 2, the 
heap manager may be able to combine 
two freed leaves from the smaller HAT to 
allocate a leaf in the larger one. 

Available electronically (see “Availabil¬ 
ity,” page 3) is code for a HAT template 
that includes some further optimizations 
to eliminate copying when die HAT grows 
and shrinks across resize boundaries. This 
is achieved at some expense of potential 
memory fragmentation, but results in 
smoother performance. The implementa¬ 
tion allows the Top array to increase as a 
multiple of its former ideal size until an 
up or down threshold is reached. 

Even if resizing is not an issue, this im¬ 
plementation has other advantages. For 
example, in a 16-bit environment, no ob¬ 
ject on die heap can exceed 64 KB. A HAT 
can manage arrays much larger dian this 
without any single leaf exceeding 64 KB. 
You could also extend HATs to automat¬ 
ically swap leaves to and from disk stor¬ 
age to support truly huge arrays with a 
minimal memory footprint. Finally, diere 
may be advantages to extending HATs to 
three or more levels rather than the two 
levels I’ve used. 

Memory Overhead 

I’ve already suggested that HATs use much 
less memory than the standard approach 
of reallocating and copying the entire ar¬ 
ray. To see how much less, I’ll compute the 
actual memory overhead of a HAT resize. 

The worst case happens when the ele¬ 
ments in the HAT are the same size as 
pointers and the number of elements is 
one greater than a resize value. If the el¬ 
ements are die same size as pointers, you 
can add die unused portion of the Top ar¬ 
ray to any wasted memory in the Leaves , 
thus maximizing the amount of wasted 
memory as a percentage of die data in the 
array; see Table 1. You can see that as the 


void vArray::append( T &el ) 

( 

// Extremely bad implementation of 
// variable length array. 

T *newTArray = new T [numElements+l]; 
for(size_t j = 0; j < numElements; j++) 
newTArraylj] = tArray[j]; 
delete tArray; 
tArray = newTArray; 
tArray[maxElements++] = el; 

) 


Example 1: A bad way to resize an array. 


Starting array of N elements in memory. 




<— N elements —► 



After one append, 2N+1 elements of memory are required. A 
fragment of N elements is created. 





<— fragment=N —> 

<- N+1 elements -> 



After two appends, 3N+2 elements of memory are required. The previous 
fragment of N elements is too small to use. 





H-fragment-2N+1 ► 

< - N+2 elements- > 



After three appends, the fragment is finally reclaimed by the N+3 elements. 


• 


< -N+3 elements-► 



Figure 1: Memory usage dining array resizing. 



Top 


-H 


-H 


> 


] = Currently Unused 


7 igure 2: HAT data structure. 
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Powerful mew resources for 

TODAY'S COMPUTER PROFESS/Omi... 



A, Cairo, FYI Software, North 
Haven. CT 

THE CRAFT OF WINDOWS 
95 INTERFACE DESIGN 

CLICK HERE TO BEGIN 

This book guides the reader to a 
better understanding of how to 
make Windows software simple 
to navigate and a pleasure to use. 
The author concentrates on some 
important design techniques such 
as prototyping. UI bulking. Rapid 
Layout Comparison, and the Side- 
by-Side Design Approach. Readers 
are assumed to have a working knowledge of development tools 
such as Visual C++ and to be working with the Microsoft Guidelines 
for Interface design. 

1996/approx. 200 pp./Softcover/$29.95/ISBN 0-287-94814-7 



Y. Fislicr, University of California, 
San Diego 

SPINNING THE WEB 

A GUIDE TO SERVING INFORMATION 
ON THE WORLD WIDE WEB 

Provides the latest web innovations: 
WWW programming with Java and 
JavaScript. Aimed at the reader 
who is comfortable with computers, 
the book discusses how to set up 
sites, ensure security, and present 
information effectively. 

1996/560 pp./Softcover/$27.95 
ISBN 0-287-94539-3 


Web Publisher’s 

| lllustitiled Quick Reference 
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R, Grahonski, XYZ Publishing, Ltd, 
Canada 

THE WEB PUBLISHER’S 
ILLUSTRATED QUICK 
REFERENCE 

A reference guide to both HTML and 
VRML. HTML 3.0 new features are 
covered as is VRML, each HTML and 
VRMI command is given a description, 
its syntax, and examples of its use. 
Also includes: Visual snapshots of each 
markup in use; each HTML tag is 
marked with its version number to 
highlight the new 3.0 features. Covers 


ail the known VRML tags for 2.0 

1996/approx. 304 pp./Softcover/$34.95/ISBN 0-387-94831-7 


R. Slade, North Vancouver, BC, 
Canada 

ROBERT SLADE’S GUIDE 
TO COMPUTER VIRUSES 

HOW TO AVOID THEM, 

HOW TO GET RID OF THEM, 

AND HOW TO GET HELP 

Covers all systems: micro, network, 
and mainframe and is suitable for 
professional IT managers and desk¬ 
top users. Robert Slade presents 
the details of viruses, shows how 
to protect against infection, as 
well as reviews of the major anti¬ 
virus software packages. 

From reviews of the first edition: 

"The most comprehensive and up-to-date volume I have seen in 
years....easily readable and understandable....The extensive work 
and research done by the author is clearly evident." 

Harold Joseph Highland, Computers and Security 

"... definitive, educational, and entertaining - all in one volume ." 

Peter Neumann, RISKS Forum 
1996/440 pp./Softcover/$34.95/ISBN 0-387-94663-2 


D. A, Wheeler, Institute for Defence 
Analysis, Alexandria, VA 

ADA 95 

THE LOVELACE TUTORIAL 

Provides an introduction to Ada 95, 
one of the most widely used pro¬ 
gramming languages in the world. 
Although the reader is assumed to 
have a basic understanding of pro¬ 
gramming, no prior exposure to Ada 
is assumed and all the basics of the 
language are covered. One of Ada 
95s new features, its object-orient¬ 
ed facilities, is covered in depth, and 
ali of the essential features of Ada 
programming are covered thoroughly. 

1996/approx. 320 pp./Hardcover/$49.95 (tent.) 

ISBN 0-387-94801-5 




TO ORDER 

VISIT: Fine bookstores near you. 

CALL: 1-800-SPRINGER 
EMAIL: orders@springer-ny.com 

CIRCLE NO. 236 ON READER SERVICE CARD 
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inline size_t Hat::topIndex(const size_t j ) const 
{ 

// Get the high index, 
return j >> power; 

} 

inline size_t Hat::leafIndex(const size_t j ) const 
( 

// Get the low index, 
return j & ((l<<power)-l); 

} 

inline T &Hat::operator[](const size.t j) const 
{ 

// Return an element in the HAT. Do no bounds 
checking. 

return top[topIndex(j)][leafIndex(j)] ; 

) 


Top/Leaf 

Size 

Worst 

N 

Worst Waste 
(top+leaf-1) 

Percent of Data 

2 

3 

1+2=3 

100 

4 

5 

4+3=7 

140 

8 

17 

8+7=15 

80 

16 

65 

16+15=31 

48 

32 

257 

32+31=63 

25 

64 

1025 

64+63=127 

8 

128 

4097 

128+127=255 

6 

256 

16385 

256+255=511 

3 


Example 2: Fast indexing with bit operations. 


Table 1: Worst-case memory overhead. 


HAT grows, the percentage of wasted 
memory in the worst case drops dramat¬ 
ically. Generally, the worst-case memory 
waste is (top+leaf-1) ~= 2*sqrt(N) = 

(continued from page 108) 

0(sqrt(N)). If you expect the last leaf to 
be half full, the expected memory waste 
drops to (top + leaf/2) ~= 1.5*sqrt(N), 
which is still 0(sqrt(N)). This overhead 
compares well with other data structures 
fhat can add elements in expected 0(7) 
time. For example, singly linked lists re¬ 
quire O (AO memory overhead (one point¬ 
er for each element). 


Performance 

^n a built-in C++ array, the address of 
the element is computed by adding the 
index of the element, times its size, to 
the start of the array. By comparison, 
rinding the address of an element in a 
HAT requires two such array lookups, a 
oointer dereference, and the toplndex 
and leaflndex calculations. By precom¬ 
puting ( l«power)-l , this becomes two 
array lookups, a pointer dereference, a 
Dit shift, and an & operation. On mod¬ 
ern processors, the last three can be 


done very quickly. This means that HAT 
elements can be dereferenced in about 
twice the time required for a C++ array. 

Figure 3 shows the results of a quick¬ 
sort implementation comparing standard 
C++ arrays and HATs. This algorithm uses 
array references very heavily, and sup¬ 
ports the estimate that HATs are about 
twice as slow as regular arrays. 

Figure 4 compares the two types of ar¬ 
rays under slightly different circumstances. 
In this case, N random integers are ap¬ 
pended to the array and then sorted. Even 
though the HAT is slower for array refer¬ 
ences, the faster append makes the over¬ 
all operation of this test significantly faster. 

The benchmarks compare HATs to a re¬ 
sizable-array class implemented in the stan¬ 
dard way (reallocate and copy) that grows 
by 64 elements whenever it runs out of 
space. The quicksort algorithm is a tem¬ 
plate that accepts either resizable-array class. 
All benchmarks were run on a lOOMhz HP 
700 series PA-RISC workstation running 
HPUX 9.01 with 256 MB of memory. 

Conclusion 

HATs are a practical and efficient way 
to implement variable-length arrays. 


They offer highly desirable O(A0 per¬ 
formance to add N elements to an emp¬ 
ty array and only require O(sqrt(A0) 
memory overhead. They provide all the 
ease of use and standard features of nor¬ 
mal arrays, including random access to 
elements. They maintain their perfor¬ 
mance and memory-usage characteris¬ 
tics over any number of elements and 
require no special application perfor¬ 
mance tuning. 

Although Hashed-Array Trees require 
more time to access their elements, this 
drawback is often far outweighed by 
their fast resizing, efficient memory uti¬ 
lization, and high programmer conve¬ 
nience. They offer strong advantages 
over other methods of implementing 
variable-length arrays. 
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figure 3: Quicksort with standard arrays and HATs. 


Figure 4: Append and Sotl with standard arrays and Hats. 
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From your mind’s eye 
to the user’s screen... 

A great user interface takes more than a set of 
buttons and text entry Fields. You want users to 
see the data as it was meant to be shown: in 
tables, maps, charts, graphs, even hypertext pre¬ 
sentations. Standard GUI builders take you part 
of the way, but ILOG Views™ 2.2 gives you the 
powerful tools you need to make your interface 
come alive. ILOG Views spans the whole range 
of GUI requirements, from simple form-based 
systems to sophisticated high-performance data 
visualization applications. 

ILOG Views is a C++ software component for 
full GUI development, with outstanding perfor¬ 
mance on both Unix and Window's platforms. 
Modular, flexible, and extensible. ILOG Views 
is designed to integrate readily with new or 
legacy applications. 


ith the ILOG Views Studio interface builder, 
you can merge standard interface components with 
advanced graphic objects to generate powerfid, 
portable C++ user interfaces. 









































































UNDOCUMENTED CORNER 


Detecting Intel 
Processors 

Knowing the generation of 
a system CPU 

Robert R. Collins 


T he debate about the correct way to 
detect different generations of Intel 
microprocessors has raged for years. 
In one corner are programmers who 
traditionally used a series of PUSHF/POPF 
instructions to detect the FLAGs differ¬ 
ences between processors. In the other 
corner, it always seemed I stood alone, 
arguing that this technique is flawed. The 
debate subsided somewhat in 1989, when 
Intel published an algorithm that relied 
upon PUSHF/POPF for microprocessor 
identification. But even while the naysay¬ 
ers said, “See, even Intel does it our way,” 
I stood in my little corner saying “Sure, 
but it’s wrong.” 

The truth is, neither algorithm is fail¬ 
safe. Intel’s PUSHF/POPF method can mis¬ 
diagnose which processor family is run¬ 
ning and does not guarantee to operate 
outside of real mode. My technique should 
always run in v86 mode, but sometimes 
doesn’t because of shortcomings in the 
design of many v86-memory managers— 
like EMM386 from Microsoft. 

Intel's Algorithm 

All current-generation Intel x86 proces¬ 
sors have an instruction called CPUID that 
reads CPU identification information. This 
information can be used by software to 
dynamically take advantage of processor- 
specific programming techniques. Before 
CPUID, you needed to write an algorithm 
to detect differences between different 
generations of processors. This algorithm 
would serve much of the same purpose 
as executing the CPUID instruction. Intel 


Robert is a design verification manager at 
Texas Instruments'Microprocessor Design 
Center Robert can be reached via e-mail 
at rcollins@ti.com. 


didn’t invent the algorithm; the company 
borrowed one that was in wide distribu¬ 
tion on the Internet, and published it in 
the i486Microprocessor Programmer's Ref¬ 
erence Manual (Intel Corp. 1990), claim¬ 
ing “Copyright Intel Corporation.” Oddly, 
the original algorithm was published in 
two halves, in opposite ends of the man¬ 
ual. Section 22.10 contained the algorithm 
to detect the differences between 8086 
through 80386. Figure 3-23 contained the 
algorithm to detect the difference between 
the 80386 and 80486. The latest edition of 
this manual removes the code fragments, 
referring you to “AP-485, Intel Processor 
Identification With the CPUID Instruction,” 
Order Number 241618 (ftp://ftp.intel.com/ 
pub/IAL/software_specs/ap48504f.pdO. 
AP-485 includes the following comment: 

Please understand that the code sequences 
have been validated by Intel to detea CPU_ID, 
math coprocessor function, and initialize ac¬ 
cordingly. Any other approach may produce 
unpredictable results in future processors. 

It’s ironic that Intel claims that “any oth- 
er approach may produce unpredictable 
results,” since its algorithm is prone to fail¬ 
ures that yield unpredictable results (as 
I’ll demonstrate in this article). For more 
information on CPUID, see the text box 
“Pentium Detection,” by Robert Moote 
(which accompanied the article “Processor- 
Detection Schemes,” by Richard C. Lei- 
necker, DDJ, June 1993). 

The Intel algorithm relies on a series of 
PUSHF/POPF instructions to set and clear 
various FLAGs bits. Each generation of pro¬ 
cessor has a slightly different behavior 
which may be detected by this approach. 
This algorithm makes no attempt to detect 
the 80186/88 series of processors. In this 
regard, the algorithm is incomplete. 



The 8086/88 is distinguished from the 
80286 by attempting to clear bits 12-15 
of the FLAGs register. The 8086/88 will al¬ 
ways set these bits, regardless of what val¬ 
ues are popped into them (see Listing 
One; listings begin on page 115). The 286 
treats these bits differently. In real mode, 
these bits are always cleared by the 286; 
in protected mode, they are used for IOPL 
(I/O Privilege Level) and NT (Nested 
Task). To continue the detection code, 
you need to set bits 12-15 in the FLAGs 
register, and see if they are cleared by the 
processor. If they are, then a 286 has been 
detected (see Listing Two). 

If you get beyond this point in the al¬ 
gorithm, you know you have at least a 
386. Therefore, it is safe to use 32-bit in¬ 
structions, like PUSFIFD/POPFD. This will 
be necessary in detecting the difference 
between a 386 and 486. These processors 
are distinguished from each other by at¬ 
tempting to set the AC flag in the EFLAGs 
register. This flag was introduced in the 
486. The 386 never sets this bit, and al¬ 
ways clears it when it is set by POPFD. 
Therefore, to detect the difference l^etween 
these processor generatioas, the algorithm 
attempts to set this bit, to see if it is latched 
or cleared by the processor (see Listing 
Three). 

At this point in the algorithm, you’re 
almost home. To detect the difference 
between the 486 and the Pentium, you 
attempt to set another new EFLAG bit 
(bit-21) called the “ID flag.” This flag has 
only one purpose—to indicate the pres¬ 
ence of the CPUID instruction. This bit 
was first introduced on the Pentium, but 
later retrofitted into the 486. If the CPUID 
instruction exists on either processor, it 
may be executed to return the processor- 
identification information. 486s without 
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the CPUID instruction will not be able to 
toggle this bit. Therefore, it is safe to ex¬ 
ecute a sequence of instructions on ei¬ 
ther processor that detects the proces¬ 
sor’s ability to toggle this bit (see Listing 
Four). 

Once the algorithm gets to this point, 
you can execute the CPUID instruction to 
obtain the processor identification. This 
instaiction can be run in any processor 
mode, at any privilege level. On the Pen¬ 
tium and 486, the CPUID instruction has 
two levels: 

• Level 0 returns a vendor ID string in 

EBX:EDX:ECX, which says “Genuine- 

Intel” when printed as ASCII text. 

• Level 1 returns the processor identifi¬ 
cation signature—the same signature 

that appears in the EDX register after a 

processor RESET (see Listing Five). 

The complete Intel algorithm is avail¬ 
able in AP-485, or via anonymous FTP at 
ftp://ftp.intel.com/pub/IAL/tools_utils_ 
demos/cpuid3.zip. 

The Caveats 

In spite of Intel’s claim, this algorithm is 
far from perfect. For one thing, it fails to 
detect the 80186/88 series of processors. 
Even though this processor wasn’t adopt¬ 
ed by many PC manufacturers, it was used 
in some computers, primarily notebook 
computers. The 80186/88 processor con¬ 
tains most of the new instructions and 
CPU-generated exceptions contained in 
the 80286. These instructions include 
PUSHA/POPA , PUSH imined, SHL reg, 
immed, and the invalid opcode exception. 
The only 80286 instructions and excep¬ 
tions not implemented in the 80186/88 are 
those specifically used for protected mcxle. 
Failure to detect this processor could pro¬ 
hibit the use of some software that can 
take advantage of these new instructions 
and exceptions. 

This algorithm is only designed to run 
in real mode, not in a virtual-8086 DOS 
box running under Windows. This limi¬ 
tation is even mentioned in the 486 man¬ 
ual. This results from the fact diat PUSHF 
and POPF are privileged instructions that 
are sensitive to the I/O Privilege Level 
while running in protected mode. (DOS 
boxes, running under Windows, run in 
virtual-8086 mode—a special form of 
protected mode.) If IOPL is not equal to 
three, then a general-protection fault oc¬ 
curs while attempting to execute these 
instructions. The operating system then 
intervenes to emulate the instruction as 
it sees fit. Therefore, there is no guar¬ 
antee that the operating system will mim¬ 
ic the real-mode behavior of the specif¬ 
ic processor under test. In reality, this 
may not be as big a problem as it 


sounds. Windows sets IOPL equal to 
three for DOS boxes. This renders these 
instructions transparent to the operating 
system, and they execute without gen¬ 
erating a fault. 

Not all operating systems with a DOS- 
compatibility box follow the example set 
by Windows. OS/2 Warp uses a special 
form of virtual-8086 mode, called Virtu¬ 
al Mode Extensions (VME). Running in 
VME affords the protection advantages 
of running at IOPL=2 without incurring 
the faults generated by PUSHF/POPF 
used in this algorithm. (See http://www 
.x86.org/vmel for a discussion on VME.) 
To accommodate this behavior, 
Intel modified the algorithms of PUSHF/ 
POPF to allow them to run in VME with¬ 
out faulting to the host operating sys¬ 
tem. When IOPL<3, PUSHF always push¬ 
es an IOPL value of three onto the stack. 
This doesn’t cause any problems for the 
Intel algorithm, as none of the detection 
code depends upon setting or clearing 
these two bits alone. 

Should the CPUID instruction ever re¬ 
turn a signed number (for example, 
80000001h), the Intel algorithm will fail. 
In Listing Five, die instruction above the 
designated <- symbol is a conditional 
jump based on a signed comparison. This 


is a common programming error which 
can easily be fixed in the Intel algorithm. 

This algorithm relies on undocumented 
processor behavior to detect the differ¬ 
ences between early generations of Intel 
processors. The use of such programming 
tricks violates Intel’s own recommenda¬ 
tions. Consider the following guidelines 
set forth in various Intel manuals: 

Reserved Bits and Software Compatibility 

Software should not try to identify features by 
exploiting programming tricks, undocument¬ 
ed features, or otherwise deviating from the 
guidelines presented in this application note. 

When bits are marked as reserved, it is es¬ 
sential for compatibility with future proces¬ 
sors that software treat these bits as having a 
future, though unknown, effect. The behav¬ 
ior of reserved bits should be regarded as not 
only undefined, but unpredictable. Software 
should follow these guidelines in dealing with 
reserved bits: 

• Do not use undocumented features of a pro¬ 
cessor to identify steppings or features. 

• Do not depend on the states of any reserved 
bits when testing the values of registers which 
contain such bits. Mask out the resewed bits 
before testing. 

• Do not depend on the states of any reserved 
bits when storing to memory or to a register. 

• Do not depend on the ability to retain in¬ 
formation written into any reserved bits. 


Visual Prolog 



•Make your programs 
easier to specify, faster 
to develop and cheaper 
to maintain. 

•Easier than C++. More 
powerful than Basic. 

•Get a “Trial” version for 
only $ 129. 

Includes the complete 16-bit 
version CD with limited 
support. Full doc. only on disk. 
Limited time offer. 


For more information visit: 
http://www.pdc.dk/vip 
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Prolog Development Center. Phone 800 762-2710,404 873-1366, Fax 404 872 5243 

Outside US 
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• When loading a register, always load the re¬ 
served bits with the values indicated in the 
documentation, if any, or reload them with 
values previously read from the same reg¬ 
ister. 

These guidelines were quoted from a 
combination of two sources: Pentium Pro 
Family Developer's Manual, Volume 3: Op¬ 
erating System Writers Manual (1996), 
section 1.3.2 and AP-485Application Note: 
Intel Processor Identification With the 
CPUID Instruction. Very similar guidelines 
also appear in the 80386 High Perfor¬ 
mance Microprocessor with Integrated 
Memory Management Unit (1985), section 
2.3.10; i486Microprocessor (1989), section 
2.1.6; and Pentium Processor Family De¬ 
veloper's Manual, Volume 3 (1995), sec¬ 
tion 1.3.2. 

These are strong guidelines set forth in 
Intel’s documentation, and the irony of 
Intel’s algorithm is that it violates each 
and every one of them. Detecting the dif¬ 
ference between 8086/88 and 80286/88, 
and between 80286/88 and 80386, com¬ 
pletely depends upon setting and clear¬ 
ing reserved bits in the FLAGS register, 
and then depends on the state of those 
bits when they are stored to a resultant 
register. Detecting the difference between 
386 and 486, and between 486 and Pen¬ 
tium, depends upon setting an EFLAGs 
bit that is undefined on the previous-gen¬ 
eration processor, then depends on that 
processor to clear the undefined bit. To 
abide by Intel’s guidelines, the behavior 
of these undocumented FLAGs bits must 
be documented in their respective man¬ 
uals— but they aren’t. None of these dif¬ 
ferences are documented in any of the 
processors’ respective data sheets. Pro¬ 
cessor behavior often isn’t documented 
until many years after release. The 8086 
FLAGs behavior was first described in the 
386 programmer’s reference manual in 
1988 (nearly ten years after the 8086’s in¬ 
troduction). The 80286 FLAGs behavior 
wasn’t described until the Pentium man¬ 
uals were introduced in 1993 (ten years 
after the 80286 introduction, and four 
years after Intel introduced this algorithm 
in the 486 manuals). 

Even though Intel’s algorithm violates 
all of its own guidelines, the company 
is partially exonerated by the Pentium 
programmer’s reference manual, where 
Intel says that it’s acceptable to use this 
algorithm to detect the differences in 
these processors. However, the Pentium 
manual doesn’t change the prohibitions 
set forth in the 386 or 486 manuals; those 
prohibitions still exist. The following ex¬ 
cerpt was taking from the Pentium Pro¬ 
grammer's Reference Manual, chapter 5: 

The setting of the flags stored by the PUSHF 
instruction, by interrupts, and by exceptions 
is different on the 32-bit processors than that 


stored by the 8086, and Intel 286 processors 
in bits 12 and 13 (IOPL), 14 (NT), and 15 (re¬ 
served). These differences can lx; used to dis¬ 
tinguish what type of processor is present in 
a system while an application is running. 

My biggest objection to this algorithm 
is that it’s prone to failure on all pro¬ 
cessors newer than a 386. When it fails, 
the algorithm incorrectly determines that 
a 386 processor is installed in the sys¬ 
tem. The failure is caused when an in¬ 
terrupt occurs precisely where the re¬ 
appears in Listing Three. When this oc¬ 
curs, the AC flag is cleared (in real 
mode), and the algorithm fails to detect 
the correct processor type. The AC flag 
has always behaved in this manner, but 
the behavior wasn’t documented until 
the 1994 edition of the Pentium Pro¬ 
grammer's Reference Manual (chapter 
25, description of INT instruction). There 
are a few ways to demonstrate this fail¬ 
ure (assuming you’re running on a 486 
or later processor). You can put an HLT 
instruction or an INT instruction at the 
point designated by the or run the 
algorithm in a loop. Eventually, a timer- 
tick interrupt will occur at this point. In¬ 
serting an HLT instruction will force the 
processor to wait for an interrupt before 
continuation. When the interrupt occurs, 
the AC flag will be cleared during its in¬ 
vocation. Listing Six presents source code 
to demonstrate this behavior. 

Conclusion 

The Intel algorithm isn’t nearly as bad as 
it sounds. It has a few bugs that can eas¬ 
ily be fixed. Intel’s intentions were noble, 
but their implementation was flawed (see 
http://www.x86.org for an updated ver¬ 
sion of tliis algorithm). In spite of its draw¬ 
backs, the reasoas this algorithm is in such 
widespread use are simple: 

• It’s conveniently available and published 
by Intel. 

• It works—most of the time, even in 
v86 mode. 

The biggest drawbacks are that it’s not 
guaranteed to work outside of real mode, 
and it depends upon undocumented pro¬ 
cessor behavior. It would be nice if an al¬ 
gorithm existed to get the actual stepping 
information of processors that didn’t sup¬ 
port the CPUID instruction, and didn’t 
rely on undocumented processor behav¬ 
ior. In my next column, I’ll present such 
an algorithm, discuss its strengths and 
weaknesses, along with a comparison of 
the two algorithms under real operating 
conditions. 


DDJ 

(Listings begin on page 115.) 
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.features.ecx. ecx 


JAVA 


listing One 

iaport java.applet.*: 
inport jovo.awt.*; 


public void inlt() 

sctBackground(Color.white); 

SpaceLayout In = new SpaceLayoutO; 
oetLayout(ln); 

Button a = new Button("Start"): 

Label la » new Label("Start Engines"): 

Button b “ new Button("Inpulse"): 

Button c = new Button("Warp"); 

Button o « new Button("Scotty"); 

Label le = new Label("Call Scotty Nowl"): 

add("A", a); // Note: always give cocponento a nano! 

add(null, la): 

add("B". b); 

add("C". c); 

add("B", c): 

add(null, le): 

ln.setHGap(2); 

ln.setVGap(S); 

In.aetConstraints(Constraints.RIGHT.Constraints.CENTER.false.5.5.a): 
In.setConstraints(Constraints.LETT .Constrainta.CENTER,false.5,5,1a); 

Is.sotConst raint s(Const raints.RIGHT.Constraints.CENTER,false,80.5.b): 
In.aetConstraints(Constraints.LEFT,Constraints.CENTER,true,20,5,c): 

In.setConstraints(Constraints.RIGHT.Constraints.CENTER,false.5,5.e); 
In. setConot raint s(Constraints.LEFT,Const rainta.CENTER,false,5,5,1e); 


UNDOCUMENTED CORNER 


Listing One 

pushf ; push original FLAGS 

pop ax : get original FLAGS 

cov cx, ax ; save original FLAGS 

and ax. 0fffh ; clear bits 12-15 in FLAGS 

push ax ; save new FLAGS value on stack 

popf ; replace current FLAGS value 

pushf : get new FLAGS 

pop ax ; store new FLAGS in AX 

and ax, 0f000h : if bits 12-15 are set. then 

cep ax, Bf000h : processor is an 8086/5038 

nov _cpu_type, 0 : turn on 8086/8038 flag 

je cnd_cpu-type : junp if processor is 8086/8088 

Listing Two 

or cx, 0f000h ; try to set bits 12-15 

push cx ; save new FLAGS value on otack 

popf ; replace current FLAGS value 

pushf ; get new FLAGS 

pop ax ; store new FLAGS in AX 

and ax. 0f000h ; if bits 12-15 are clear 

nov _cpu_type, 2 ; processor»80286. turn on 80286 flag 

j* end_cpu_typc : if no bits set. procascor is 80286 

listing Three 

pushfd ; push original EFLAGS 

pop eax ; get original EFLAGS 

bov ecx. eax ; save original EFLAGS 

xor eax. 40000h ; flip AC bit in EFLAGS 

push eax ; save new EFLAGS value on stack 

popfd ; replace current EFLAGS value 

<- 

pushfd ; get new EFLAGS 

pop eax ; store new EFLAGS in EAX 

xor eax, ecx : can't toggle AC bit. proccssor“80386 

nov .cpu_type, 3 : turn on 80386 processor flag 

jz cnd.cpu.type ; junp if 80386 processor 

push ecx 

popfd ; restore AC bit in EFLAGS first 

Listing Four 

=ov _cpu_type. 4 : turn on 80486 processor flog 

cov eax. ecx : get original EFLAGS 

xor eax. 200000h ; flip 10 bit in EFLAGS 

push eax : save new EFLAGS value on stack 

popfd ; replace current EFLAGS value 

pushfd : get new EFLAGS 

pop eax : store new EFLAGS in EAX 

xor eax, ecx ; can't toggle 10 bit. 

je cnd.cpu.type : processor=80486 

listing Five 

bov _cpuid_flag, 1 : flag indicating uso of CFUID inst. 

push obx ; save registers 

push esi push edi 

bov eax. 0 ; set up for CPUI0 instruction 

CPU.I0 ; get and save vendor 10 

bov dvord ptr .vendor.id. ebx 
bov dword ptr .vendor.id[+4), cdx 

aov dword ptr .vendor.id[+8]. ecx 

bov si. ds 

bov es. si 

bov si, offset .vendor.id 

nov di, offoot Intel.id 

cov cx. 12 : should be length intel.id 

cld ; set direction flag 

repe cnpsb ; coapare vendor 10 to "Genuinolntel" 

jne esd.cpuid.type ; if not equal, not on Intel processor 

bov .intol.CPU, 1 ; indicate an Intel processor 

enp eax, 1 : nake sure 1 is valid input for CPUIO 

jl end.cpuid.type ; if not. junp to end 

cov eax, 1 

CPU.ID ; get fanily/codcl/stepping/features 

bov .cpu.signature. eax 

bov .featurcs.cbx, ebx 

bov .features.edx, edx 


ahr eax. 8 ; isolate fanily 

and eax. 0fh 

bov _cpu-typo, ol ; set _cpu_type with faaily 

Listing Six 

TITLE intel 

0OSSEG 

.oodel snail 

.stack 100h 

...... include file section - 

includelib \nasn\lib\niscutil.lib 
includolib \nasn\lib\videofns.lib 

: - External declarations - 

extrn _get.fpu.type: proc 

extrn _get.cpu.type: proc 

extrn Sot.cursor: proc 

extrn Got.cursor: proc 

extrn HEX320UT: proc 

extrn CLS: proc 

extrn _cpu_type: byte 

extrn _fpu_type: byte 

extrn .cpuidlflag: byte 

extrn .intel.CPU: byte 

extrn .vendor.id: byte extrn .cpu.signature: dword 

oxtm .features.ecx: dword 

extrn .features.edx: dword 

extrn .features.ebx: dword 

:- Local variables & Equates —— 

KBD.RcadFn equ 0 : function to read keyboard 

KBB.StatusFn equ 1 ; function to read keyboard status 

;-Mice data variables-— 

.data 

PSoricsMsg label byte 
db "P6: 

P6Buffer db " ".0dh.0ah 

db "P5: " 

P5Buffer db " ".0dh,0ah 

db "P4: 

P4Buffer db " ",0dh.0oh 

db "P3: " 

P3Buffer db " ",0dh.0ah 

db "P2: 

P2 Buffer db " ",0dh.0ah 

db "P2: • 

PlBuffer db " ".0dh,0ah 

db "P0: " 

P0Buffcr db " ".0dh.0ah.24h 

P6Count dd 0 

PSCount dd 0 

P4Count dd 0 

P3Count dd 0 

P2Count dd 0 

PICount dd 0 

POCount dd 0 

CPUTbll dw offset P6Count 

dw offset P5Count 

dw offset P4Count 

dw offset P3Count 

dw offset P2Count 

dw offset PICount 

dw offset POCount 

CP0Tbl2 dw offset P6Buffer 

dw offset P5Buffer 

dw offset P4Buffer 

dw offset PSBuffer 

dw offset P2Buffer 

dw offset PlBuffer 

dw offset P0Buffer 

CPUIO.Buffcr db " $" 


.code 

.8086 

start: nov ax, Odata 

nov ds, ax ; set segnent register bov es, ax ; set 

segaent register 

and op, not 3 ; align stack to avoid AC fault 

call CLS ; clear screen 

call Get.cursor 

bov ah,9 

bov dx,offset PSeriosKsg : get aessoge buffer address 

int 2lh 

nov P6Buffer[8]; cake ASCII$ string 

bov P5Buffer[8),•$' ; nako ASCII$ string 

cov P4Buffer(8]: cake ASCII$ string 

nov P3Buffer[8].'$* ; sake ASCII$ string 

nov P2Buffer(8).: cake ASCII$ string 

BOV PlBuffer(8).; cake ASCIIS string 

cov P0Buffer[8], '$■ ; coke ASCII$ string 

fiGctCPUIB: 

call _get.cpu.type : detersino processor type 

call print 

oov _cpu.type.0 ; clear it...for later 

bov ah.KBD.StatusFn ; got keyboard status 

int 16h : read keyboard status 

j* OCetCPUID 

nov ah.KBB.ReadFn ; read koyboard function 

int 16h : get get key 

nov ax, 4c00h ; terainate progron 

int 21h 

:—— print proc near- 

xor bx.bx 

nov bl..cpu.typo ; get CPUIO 

shl bx,l ; *2 

bov si,CPUTbll[bx] ; get pointer to variable 

add word ptr [si),l ; adjust CPUIO counter 

adc word ptr [si][2],0 

cov dx,608h : get initial row/col pointer 

sub dh.byte ptr _cpu_type 

call Set.cursor ; set cursor position 

bov si,CPUTbll(bx) 

bov di,CPUTbl2(bx) ; get buffor pointer 

call HEX320UT ; do buffer 

bov ah, 9 ; print it 

bov dx,CPUTbl2(bx] : get buffer address 

int 21h 

ret 

print endp 

end start 
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Course on C/C++ 



1 Stevens, a world renowned programming expert 
and contributing editor for Dr. Dobbs Journal, 
has created the CD-ROM to answer all your 
C/C ++ programming questions - the Al Stevens Cram 
Course on C/C++. 


This CD-ROM includes the complete text of three books 
written by Al Stevens, an interactive step-by-step tutorial 
with precise explanations, video clips of Al discussing 
important topics, a compiler directly connected to the 
exercises, lots of usable source code, plus a memory feature 
that bookmarks your place for quick returns to prior sessions. 


Use this CD-ROM on your programming projects to 
answer questions, work through actual examples, compile 
your example source code, and make sure it s correct 
right then and there. 


Or complete the form and return to : 

Fax: 913-841-2624; E-mail: orders@mfi.com; 
Int’l: Use mail, fax, e-mail, or call 913-841-1631 


Please send me an Al Stevens Cram Course on C/C++ CD-ROM 
today! My price is $69.95 (plus $2.00 U.S./Canada; all other countries 
$10.00). Please add sales tax in the following states: CA (8.5%); 

GA (6%); IL (6.25%), KS (6.9%), NY (8.25%), TX (8.25%) 


Name 


Address 


No matter what your level of programming expertise, the 
Al Stevens Cram Course on C/C++ will help you become a 
more proficient programmer. 

This multimedia CD-ROM features: 

• Three Complete Programming Books 

• Interactive Tutorials 

• Built in Compiler 

• Video Clips 

• Bookmark for Quick Returns 

• Background Music Performed by Al Stevens 

See screen shots and a more detailed explanation on our 
Website: www.ddj.com/cdrom/alstevens.htm 

* . 

Includes these Books by Al Stevens: 



Welcome to Programming 

Straight forward explanations of 
computer files, code, and language 
makes programming simple. 



Al Stevens Teaches C 

The perfect introduction to C with 
an organized, structured approach, 
teaching good programming through 
good example. 



Teach Yourself... C ++ 

This book demonstrates the hows and 
whys of C++ program design in an 
accessible, informative style. 
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PROGRAMMER'S BOOKSHELF 


Programming for Windows 95 

Lou Grinzo 


M ark Andrews’ Migrating to Win¬ 
dows 95 and Charles Petzold and 
Paul Yao’s Programming Windows 
95 provide a fascinating snapshot 
of the current state, of Windows develop¬ 
ment. One book leans fearlessly into the 
wind, eager to embrace Microsoft’s ap¬ 
proach and the onslaught of change that 
Windows coders know only too well. The 
other takes a more thoughtful approach 
and seems always to be aware of the need 
to draw the old guard among Windows 
developers along, even as it addresses new 
Windows features. 

Migrating to Windows 95 

Mark Andrews’ Migrating to Windows 95 
has 11 chapters: “Introducing Windows 
95,” “Underneath Windows 95,” “Windows 
95 Architecture,” “The Win32 API,” “Win¬ 
dows 95 and the MFC Library,” “Windows 
95 and Visual C++,” “OLE,” “Programs and 
Processes,” “Multithreading and Multi¬ 
tasking,” “Windows 95 DLLs,” and “Win¬ 
dows 95 Networking.” From this list alone 
you might wonder why this book wasn’t 
titled, “Everything you ever wanted to 
know about Windows 95, but didn’t know 
to ask.” Indeed, Andrews attempts to cov¬ 
er an amazing amount of ground in “only” 
600 pages; a more detailed breakout of 
the book’s outline would make this point 
even clearer. This attempt to encompass 
so much of the Windows 95 development 
world is the book’s greatest strength and 
also its greatest weakness. Andrews’ book 
is a perfect fit for the technically astute 
manager (not an oxymoron) who sud¬ 
denly must lead a new project and needs 
to come up to speed quickly on Windows 
95 development. In fact, this book might 
even be unique among current offerings 
in this regard; Andrews weaves together 
information at several logical levels to pre¬ 
sent an overview of the hardware and sys¬ 
tem architecture, as well as development 
tools (albeit, just those from Microsoft) 
and techniques, and provides a remark- 
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ably complete view of the Windows 95 
terrain from 10,000 feet. 

Yet for all the ground Andrews covers, 
I was disturbed by how often he presents 
statements that are defensibly correct but 
open to misinterpretation. For example, 
on page 65 he says that Windows 95 sup¬ 
ports 16-bit Windows programs, which 
gives you a choice of writing 16- or 32- 
bit programs. But he says that to create 
one program that runs under both Win¬ 
dows 3.x and Windows 95, you must write 
a 16-bit program. What about Win32s? I’m 
certainly no fan of Win32s; I think it’s one 
of the ugliest hacks ever foisted upon pro¬ 
grammers. But to fail to mention it in this 
context is odd, indeed. 

Similarly, Andrews is uncomfortably ea¬ 
ger to embrace Windows 95/Visual C++ 
4.0/MFC 4.0/OLE as The One True Way. 
He acknowledges on page 242 that you 
might choose to develop using a compiler 
other than VC++, but adds that you should 
still learn to use VC++ 4.0 first. Given the 
learning curve associated with mcxlem com¬ 
piler packages and the horrifically short de¬ 
velopment schedules many of us face, this 
is odd advice. Tliis is just one example, but 
it is characteristic of Andrews’ reliance on 
Microsoft tools and techniques. In all fair¬ 
ness, he is true to his convictions and 
spends a considerable number of pages de¬ 
tailing development techniques using VC++ 
4.0. The problem is that, aside from being 
narrowly focused on one set of tools, his 



treatment is not detailed enough to be a 
generally useful resource for programmers 
in the trenches. Tliis shouldn’t be a surprise; 
there are books on the market larger than 
Andrews’ that cover nothing but using 
VC++, so he could hardly match their depth 
and breadth in only part of his book. 

I was also bothered by Andrews’ chap¬ 
ter 1 inclusion of extensive quotes from 
Microsoft marketing people about their 
goals and design decisions for Windows 
95. This material is interesting, but I ques¬ 
tion its appropriateness in a book subti¬ 
tled “Programmer’s Guide to What’s New,” 
especially when presented in a noncriti- 
cal fashion. Repositioned as an overview 
for technical managers and perhaps reti¬ 
tled “Migrating to Windows 95: What Ev¬ 
ery Technical Manager Needs to Know,” 
I think this book makes far more sense. 

Programming Windows 95 

And now we have, at long last, the up¬ 
date to the Windows programming book 
(the one everyone recommends to new¬ 
comers and is universally known by the 
author’s name, “Petzold”). Not surprising¬ 
ly, die publication of Programming Win¬ 
dows 95 begs several questions. 

Is it just a rehash of die “old Petzold?” 
Largely, yes. To be sure, it’s been updat¬ 
ed to include new Windows 95-specific 
features, but if you know your way around 
the “old Petzold,” the “new Petzold” will 
instantly fall to hand like your favorite 
mouse. (To be clear, I don’t mean to min¬ 
imize Paul Yao’s contribution; referring to 
this book in this way is merely my pre¬ 
diction of how it will generally lie known.) 
The chapters include “README.TXT,” “Hel¬ 
lo, Windows 95,” “Painting with Text,” “Es¬ 
sential Graphics,” “The Keyboard,” “The 
Mouse,” “The Tinier,” “Child Window Con¬ 
trols,” “Icons, Cursors, Bitmaps, and 
Strings,” “Menus and Accelerators,” “Dia¬ 
log Boxes,” “The Modern User Interface,” 
“Memory Management and File I/O,” 
“Multitasking and Multithreading,” “Using 
the Printer,” “The Clipboard,” “Dynamic 
Data Exchange (DDE),” “The Muldple Doc¬ 
ument Interface,” “Dynamic Link Libraries,” 
and “What’s This Thing Called OLE?” 

Is it still bare-bones C? Yes. In chapter 
1, Petzold says: 
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Q: What does it take to deploy a 
superior client/server application? 
A: A SUPERIOR SERVER 


START with the most 
advanced client-side SDK on 
the market: c-tree® Plus at 
$895. 

• Complete “C” Source code 

• ROYALTY FREE (Client Side) 

• Multiple supported protocols 

• Fast, portable, reliable 

• Powerful features like 
transaction processing 

• Win95, NT, and 
Windows 3.1 ready 

ADD a strong, multi¬ 
platform, industrial-strength 
Server that supports. 

• File mirroring 

• Heterogeneous networking 

• Automatic disaster recovery 

• Multi-threaded design 

• Best price/performance 
available: from $445- $3745 


RESULT? A solid, 
economical, easily 
deployable product that fits 
your needs. 

• Portable 

• Scalable 

• Exceptional Performance 

• Flexible 

• Easy Server distribution 

• Convenient OEM terms 


FAIRCOM 

Server* 


MAC 


UNIX 

Heterogeneous TCP/IP Network 


You can’t find a better client SDK with these features! 
Over sixteen years of proven reliability and performance. 
No one else supports over 30 platforms in this price range! 

c-tree Plus® 

• Complete C Source 

• Single/Multi User 

• Client/Server (optional) 

• Full ISAM functionality 

• No Royalties 

• Transaction Processing 

• Fixed/Variable Length Records 

• High Speed Data/Index Caching 

• Batch Operations 

• File Mirroring 

• Multiple Contexts 

• Unsurpassed Portability 


4 - 


FairCom Server® 

• Client/Server Model 

• Transaction Processing 

• Requires <2MB RAM 

• Online Backup 

• Disaster Recovery 

• Rollback - Forward 

• Anti-Deadlock Resolution 

• Client-side "C" Source 

• Multi-threading 

• Heterogeneous networking 

• File Mirroring 

• OEM/Source Available 
CIRCLE NO. 84 ON READER SERVICE CARD 

FOR YOUR NEXT PROJECT CALL FAIRCOM: YOU 
CANT FIND A BETTER HETEROGENEOUS 
CLIENT/SERVER SOLUTION! 

Also inquire about these FairCom products: 

d-tree™ r-tree® ODBC Driver 

FAIRCOM' 

CORPORATION 


WWWeb Address: http://www.faircom.com/ 

800-234-81 80 

U.S.A. 4006 W. Broadway - Columbia, MO 65203-0100 
phone (573) 445-6833 fax (573) 445-9698 
EUROPE Via Patrioti, 6-24021 Albino (BG) - ITALY 
phone (035) 773-464 fax (035) 773-806 
JAPAN IKEDA Bldg. #3,4f-112-5, Komei-chou - Tsu-city,MIE 514 Japan 
phone (0592) 29-7504 fax (0592) 24-9723 


SUN O/S 4.X 


SUN D/S 5.X • MIPS ABI CSGU • 


What I’m going to teach you in this book 
is what I think of as “classical” Windows 
programming. 1 use the plain old C pro¬ 
gramming language (not C++), and I use 
the raw application programming interface 
(API) directly rather than any “wrappers” 
that hide the API under easier interfaces. 

Some readers will wail at this and claim 
that it makes the book an antique in this 
age of visual development and ubiquitous, 
immense, and immensely complicated 
frameworks. That the book includes nu¬ 
merous resource scripts as .RC files, and 
that the authors provide a .BAT file for 
building programs using command-line 
tools, will make some programmers dis¬ 
miss the book. I strongly disagree— if 'any¬ 
thing, I think its approach makes it even 
more valuable. Bookstores are packed 
with books about frameworks and vari¬ 
ous Windows specialties, such as OLE, 
Windows multimedia, network program¬ 
ming, or compiler-specific development, 
and there are precious few that even at¬ 
tempt to teach you how Windows itself 
works. This relentless focus on the basics 
made the old Petzold a quite valuable (and 
some would say unique) resource because 
it laid the foundation for a good under¬ 
standing of the overall Windows’ archi¬ 
tecture; the new Petzold will easily take 
its place, in part because it’s been updat¬ 
ed so seamlessly. For example, chapter 
12, “The Modem User Interface,” presents 
the best and most-detailed treatment I’ve 
seen to date on the new custom controls 
introduced in Windows 95. 

Is this a resource for experienced Win¬ 
dows programmers moving to Windows 
95? Much of what’s here is basic Win¬ 
dows architecture, with little that is Win¬ 
dows 95 specific (including only the mer¬ 
est introduction to OLE), and is therefore 
(apparently) of little value to battle-weary 
Windows coders. But again, Pmgranwiing 
Windows 95’s almost endless detail about 
the minutiae of Windows, as well as its 
thoughtful, laid-back presentation, make 
it a resource that I know I’ll keep on my 
“primary references” shelf, no matter how 
many Windows programs I write. It’s hard 
to convey to someone who’s never seen 
the old Petzold how much solid informa¬ 
tion is in this book, even at 1100 pages. 

If you refer to your old Petzold more 
than two or three times a month and 
you’re writing Windows 95 apps, you 
should buy this book. If someone you 
know is just starting out with Windows 
programming, particularly Windows 95, 
tell that person to buy this book and read 
it cover to cover. 

But above all, be aware of this book’s 
approach, you’ll get far more from it if 
you accept it on its own terms. 

DDJ 
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Cedar Ridge Software has announced 
HypheGrid 2.0, a scrollable grid control 
for Java. Version 2.0 features include sup¬ 
port for a variety of cell types (single line 
text, multiline text, choice box, button, 
and image), support for cell level attributes 
(color, font, alignment), and support for 
row and column selection. A simple grid 
object requires only 70 KB of Java byte¬ 
code, and the most complex grid needs 
only 150 KB. 

HypheGrid lets you add scrolling grids 
of tabular data to applications. With 
HypheGrid, users can scroll through a 
large set of table rows, move and resize 
table columns, and edit data in the table 
directly through the grid. You have ex¬ 
tensive control over the appearance and 
properties of the grid embedded in your 
code. Functions are available to set col¬ 
ors and fonts for a wide variety of grid 
features. The data displayed in the grid is 
supplied by an object created by you and 
linked to the grid, and a variety of call¬ 
back functions are available to notify the 
program about grid events. 

Cedar Ridge Software 
619 Willow Avenue, 3L 
Hoboken, NJ 07030 
201-714-4804 

http://www.cnctcom/~rowland/cedarridge 

Softel vdm has released SftTree/OCX 2.0, 
an ActiveX control which offers hierar¬ 
chical data displays with features such as 
multiple columns, multiple selection, mul¬ 
tiple text lines per item, built-in row and 
column headers (with optional buttons 
and bitmaps), user-resizable columns, grid 
lines, 3-D item display, sorting, optimal 
column width, and horizontal scroll-area 
calculation. 

Several bitmaps per item can be used 
including user-definable expand/collapse 
button bitmaps and cell bitmaps. Cells of¬ 
fer individual color, font, and bitmap at¬ 
tributes to make data stand out by high¬ 
lighting it or by adding suitable bitmaps. 
The available drag-and-drop support 


assists in drag-and-drop processing inside 
one tree control and also outside. Vertical 
scrolling during drag-and-drop process¬ 
ing is fully supported. 

SftTree/OCX 2.0 includes 16-bit and 32- 
bit ActiveX controls, which support Win¬ 
dows 3.1/95/NT. The royalty-free controls 
can be used with Visual Basic, Delphi, Vi¬ 
sual C++, MS Access, and most other de¬ 
velopment tools that support ActiveX con¬ 
trols. A single-developer license for 
SftTree/OCX 2.0 sells for $269.00. 

Softel vdm 
11 Michigan Avenue 
Wharton, NJ 07885-2540 
201 - 366-9618 

1 1 11 p://www. softel vd m. com 

O’Reilly & Associates recently released 
WebSite Professional, which supports serv¬ 
er-side Java programming and ships with 
a Java software development kit (SDK). 
The class library at the heart of WebSite 
Professional’s server-side Java support en¬ 
capsulates all of the details of the inter¬ 
face between the server and server-side 
applets. Consequently, you work with ob¬ 
jects, properties, and methods that repre¬ 
sent the Web transaction. For example, 
HTML form data are represented as Java 
objects, since the class library exposes 
WebSite Professional’s built-in forms de¬ 
coder. 

O’Reilly 8c Associates 
103 Morris Street 
Sebastopol, CA 95472 
707-829-0515 
http://www.ora.com 

Microsoft has announced its Internet Se¬ 
curity Framework, a set of security tech¬ 
nologies for electronic commerce and on¬ 
line communications that supports Internet 
security standards. The framework is avail¬ 
able for Windows, Macintosh, and UNIX; 
in addition, the security framework will 
integrate with existing Windows-based se¬ 
curity systems. 

The Internet Security Framework sup¬ 
ports secure communication, controlling 
access to systems and content, and secure 
financial transactions, by providing a set 
of APIs and technologies including: 
CryptoAPI 1.0, which provides extensible, 
exportable, system-level access to com¬ 
mon cryptographic functions; CryptoAPI 
2.0, which provides a complete public key 
infrastructure, including certificate-based 
authentication services and extensible cer¬ 
tificate management functions; code¬ 
signing, which provides “shrink wrap” for 
the Internet; secure channel protocols to 
enable point-to-point communication pri¬ 
vacy; client authentication that lets servers 
verify identity via public-key certificates 
and to enforce access control; distributed 


authentication technology based on pass¬ 
words; and more. 

Development kits for the Internet Se¬ 
curity Framework will be included in the 
ActiveX SDK. 

Microsoft Corp. 

One Microsoft Way 
Redmond, WA 98052 
206 - 882-8080 

http://www.microsoft.com 

Rational Software has announced Ratio¬ 
nal Summit, an integrated tool for software 
change management, defect tracking, and 
process enforcement. Summit helps man¬ 
age the overall softw are change process, 
including resource allocation, change sub¬ 
mission and tracking, and measurement 
and management of the process. Summit 
can be customized and configured to meet 
specific change-management needs. 

The tool runs on open-systems plat¬ 
forms in conjunction with Rational Apex, 
Rational’s software-engineering environ¬ 
ment. Rational Apex supports C/C++, Java, 
and Ada and provides capabilities for edit¬ 
ing, debugging, configuration manage¬ 
ment, and architecture control. 

Rational Software Corp. 

2800 San Tomas Expressway 
Santa Clara, CA 95051-0951 
408-496-3600 
http://www.rational.com 

Creating Killer Web Sites , by David Siegel, 
is a book recently released by Hayden 
Books. The book focuses on what you 
need to know to make Web sites visual¬ 
ly appealing with easy-to-understand in¬ 
structions. It also goes beyond the usual 
icon-and-menu design tactics of most Web 
sites, teaching you “how to break the grip 
of HTML.” The book also includes tips on 
effective typography, clean graphics, site 
architecture, and information design. Cre¬ 
ating Killer Web Sites sells for $45.00; ISBN 
1-56830-289-4. 

Hayden Books/Macmillan Computer Pub¬ 
lishing 

201 W 103rd Street 
Indianapolis, IN 46290 
800-428-5331 
http://www.mcp.com/ 

Tower Technology has announced Tower- 
Eiffel Release 2.0, an object-oriented life- 
cycle development environment for build¬ 
ing reusable frameworks, applications, and 
systems. The tool is targeted at software 
developers building three-tier client/server 
systems with complex middle-tier require¬ 
ments. TowerEiffel 2.0 provides commer¬ 
cialized support for the Eiffel programming 
language, and includes an integrated de¬ 
velopment environment and tools, compi¬ 
lation technology, and reusable libraries 
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for GUI, database interface, data struc¬ 
tures, and distributed processing support. 

TowerEiffel 2.0 includes support for di¬ 
rect interoperability with C, C++, and Ob- 
jective-C; serialization for persistent stor¬ 
age and distributed processing; a 
user-configurable run time; precompiled 
static and dynamic library support; and 
object file locking. 

TowerEiffel 2.0 Professional is for Win¬ 
dows NT/95 and Linux. The tool sells for 
$995.00; UNIX versions sell for $1995.00. 
There are no run-time fees. TowerEiffel 
2.0 Lite sells for $325.00 per user on all 
platforms. 

Tower Technology Corp. 

1501 West Koenig Lane 
Austin, TX 78756 
512-452-9455 
http://www.twr.com 

Crescent Software has announced Visual 
Basic AppFramework, a Visual Basic tool 
that resides directly in the Visual Basic en¬ 
vironment and consolidates development 
steps. You use VB AppFramework to lay¬ 
out a complete custom-application frame¬ 
work to start a new project, add related col¬ 
lections of controls to any form, customize 
forms and controls without accessing the 
properties window, insert commonly used 
forms into existing projects, and “clean-up” 
nonconforming visual designs. 

VB AppFramework includes a library of 
royalty-free, professionally designed forms, 
functions, and frameworks. You can use 
the supplied elements as is, customize 
them to meet your needs, or build upon 
existing objects to include new styles, tem¬ 
plates, and frameworks. VB AppFrame¬ 
work sells for $249.00. 

Crescent/Progress Software Corp. 

14 Oak Park 
Bedford, MA 01730 
617 - 280-3000 

http://www.progress.com/crescent 

TurboPower Software has released Sys- 
Tools 1.0, a low-level system-oriented li¬ 
brary for Delphi 1.0/2.0 application de¬ 
velopment. SysTools provides sorting 
routines for handling any data type, func¬ 
tions for manipulating strings and dates, 
high-precision BCD arithmetic (with up 
to 38 digits of accuracy), routines for han¬ 
dling INI files and the registry, and more. 
SysTools also supports 16- and 32-bit com¬ 
patibility, as well as being threadsafe in 
32-bit programs. Unlike ActiveX, OCX, 
VBX, or DLL-based components, SysTools 
compiles directly into an application. The 
royalty-free toolkit sells for $149.00. 
TurboPower Software 
4775 Centennial Boulevard., Suite 114 
Colorado Springs, CO 80919 
800-333-4160 
http://www.tpower.com 


BAPCo has released SYSmark/32, a tool 
that measures performance of systems run¬ 
ning Windows 95/NT. Benchmaiking work¬ 
loads within SYSmark/32 represent word 
processing, spreadsheets, database, desk¬ 
top graphics, desktop presentation, and 
desktop publishing. SYSmark/32 includes 
components for application software, 
scripts, and data necessary to run work¬ 
loads; automated running of workload 
scripts; automatic generation and storage 
of test results, and system-configuration in¬ 
formation. SYSmark/32 sells for $99.00. 
Business Applications Performance Corp. 
2200 Mission College Boulevard 
Santa Clara, CA 95052 
408-988-7654 
http://www.bapco.com 

In conjunction with the Numerical Algo¬ 
rithms Group (NAG), Fujitsu, and Absoft, 
Imaginel has introduced the F program¬ 
ming language. F is a subset of the most- 
recent version of Fortran. F retains the 
modem features of Fortran—modules and 
data abstraction, for example— but dis¬ 
cards facilities such as EQUIVALENCE, 
which are difficult to teach, use, or de¬ 
bug. It is a safe, portable programming 
language. F may be used by the Fortran 
77 programmer as a transition to the new 
concepts in Fortran 95 or in High Perfor¬ 
mance Fortran (HPF). 

F is available for UNIX and Linux plat¬ 
forms, the 68K or PowerPC Macintosh, 
and PCs running Windows 95/NT. NAG 
is providing the compiler technology used 
in the UNIX and Linux implementations 
of F, Fujitsu the compiler technology used 
in the Windows implementations, and Ab¬ 
soft the compiler technology used in the 
Macintosh implementations. 

Two books about F, The F Program¬ 
ming Language ; by Mike Metcalf and John 
Reid (Oxford University Press, 1996), and 
Programmer's Guide to F } by Walt Brain- 
erd, Charlie Goldberg, and Jeanne Adams 
(Unicomp, 1996), are also available. 

F on Linux is free for educational users 
(via anonymous ftp at ftp.swcp.com in the 
pub/walt/F directory and at the Web site). 
Prices include $101.00 for other educa¬ 
tional users, $201.00 for professional users, 
and $301.00 for a three-platform profes¬ 
sional package. Site licenses and volume 
discounts are available. 

Imaginel 

11930 Menaul Boulevard NE, Suite 106 
Albuquerque, NM 87112 
505-323-1758 

http://www.imaginel .com/imagine 1/ 

ObjectSpace has released Web<ToolKit>, 
an ANSI/ISO-compatible C++ library for 
building HTML-based Web pages. 
Web<ToolKit> supports HTML page cre¬ 
ation using a set of C++ classes represent¬ 


ing HTML elements, including text, links, 
graphics, tables, forms, frames, and wid¬ 
gets. The library sells for $349.00 for PC 
platforms, and $475.00 for UNIX systems. 
ObjectSpace 

14881 Quorum Drive, Suite 400 
Dallas, TX 75240 
214-934-2496 

http://www.objectspace.com 

Bachman Information Systems (formerly 
Cadre Technologies and Cayenne Software) 
has announced Cayenne 2000, a Windows- 
based analysis, reporting, and resource es¬ 
timating tool for organizations undertaking 
Year 2000 date conversions for Cobol ap¬ 
plications. The tool enables you to identi¬ 
fy all date-related objects, and objects with 
which they interact, in a single Cobol pro¬ 
gram or group of programs that operate as 
a unit. Cayenne 2000 sells for $1497.00. 
Bachman Information Systems 
8 New England Executive Park 
Burlington, MA 01803 
617-273-9003 

http://www.cayennesoft.com 

Vivid Resolution for Visual Basic and HTML 
is a rapid-application generator from In- 
Tek Technologies that automatically gen¬ 
erates fully functional applications (pro¬ 
jects, forms, data access objects, and script) 
from visual application and data models 
into VB Enterprise Edition 4.0 and HTML. 
The HTML generator tags model data with 
the appropriate markup code so it can be 
read by an HTML-standardized application 
or browser. The tagged data can then be 
merged with one of the formatting tem¬ 
plates available via the Microsoft Internet 
Database Connector (IDBC). The tool will 
initially sell for $995.00. 

InTek Technologies 

5000 Peachtree Ind. Boulevard., Suite 150 
Norcross, GA 30071 
770-840-2500 
http://www.intekinc.com 

VanillaSearch, a Java search class from 
Thought Inc., provides Unicode pattern- 
matching search capabilities using stan¬ 
dard regular expression syntax derived 
from UNIX-grep/Perl syntax. VanillaSearch 
can be used with standard English or pro¬ 
grammer-defined META characters. It also 
lets you add wildcard searching to Java 
applications, understanding Java data 
types, such as String and chart]. Demos 
are available for download at no cost, stu¬ 
dent versions sell for $49.00, with com¬ 
mercial versions starting at $495.00. 
Thought Inc. 

2222 Leavenworth Street, Suite 304 
San Francisco, CA 94133 
415-928-4229 

http://www.thoughtinc.com 
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Director of Sales 
Charlie Shively 


(415) 655-4232 

Sales Manager 

John Moon 

Mid-Atlantic/Southeast 

(617) 235-8577 

Paul Miller 

California/Southwest 

(415) 655-4183 

Regional Sales Managers 


Carrie Mills 

Northwest/Texas 

(415) 655-4196 

Brenner Fuller 

Northeast/Northcentral 

(603) 588-3058 

Marketplace/Debut 
Charlie Shively 

Director of Sales 

(415)655-4232 
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National Account Manager (415) 655-4193 
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Information Bus 

Software for Developers of Distributed Applications 


> Create installations without programming using QuickBuilcT. 

> Point & click interface for file collection and compression. 

> Create Windows groups and icons for the end-user. 

> Update system files including .INI files and Windows 95 file registry. 

> Support password authorization and automatic uninstall. 

> No royalties and unlimited free technical support. 


Professional software distribution has come to 
the Internet. Net-Install™ is a full-featured in¬ 
stallation program designed for distributing soft¬ 
ware directly from World Wide Web pages. With 
a single click on a web page link, software is 
downloaded, decompressed and installed. It’s 
that simple! Bring all the capabilities of diskette- 
based installation software to your web page — 
easily and economically. 

> Dramatically simplifies software installation 
for Internet users. 

> Significantly reduces download times. 

> NET-Install for Windows 3.X/95/NT—$299. 


The award-winning, easy-to-use installation program for anyone who dis¬ 
tributes applications or data files using diskettes, CD-ROM or in-house 
networks. Find out what thousands already know—PC-Install is the best 
installation software available. 

> Create a professional installation in less than 30 minutes. ( gs 

> Includes all the great features in NET-Install—and more.. W4 

> PC-Install for Windows only $179 .^ 


Running from within Netscape. NET-Install 
offers such powerful features as user selec¬ 
tion boxes and custom titles and graphics. 


Call 800-735-2020 

for a free brochure. 


8196 SW Hall Blvd.. Suite 200 
Beaverton. OR 97008 
503-520-0504 • 503-520-9118 Fax 
CIS: 74774.222 or GO TWENTY 
Internet: info@twenty.com 


Call Cheryl Canion today at (415) 655-4182 to develop a customized advertising 
campaign tailored to yo ur marketing needs . Turn the page for more products . 


TIBCO Inc., a recognized leader in information integration 
for mission-critical environments, provides the fastest and 
easiest way to develop distributed applications. 

Rendezvous Information Bus software offers: 

■ Ideal communications tool for developing groupware 
client-server applications, and high-level protocols 

■ Open API 

■ Data exchange in heterogeneous environments 

■ Location transparency 

■ Subject-Based Addressing™ technology 

■ Reliable broadcast publish/subscribe 

■ Asynchronous RPC (point-to-point or broadcast) 

■ Scalable across thousands of nodes 

■ Support for all major platforms 

Don’t wait to save time! 

For information, call 800-675-8250 
Email: rv-info@tibco.com ■ http://www.tihco.com/rv/ 


BE TIBCO 


©1996 TIBCO Inc. • Palo Alto, California. USA 

Rendezvous and Subject-Based Addressing are trademarks and 
Information Bus is a registered trademark ot TIBCO Inc. 
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PC-Install 


Also from 20/20 Software 


Download a free evaluation version of NET-Install 
from out Web site — http://www.twenty.com/ 
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Windows OCX and DLL Controls 


B# X«o> OoeuTtch 138 |fc)j 1 it Roe/. Pirto Fla 
|S & MPUmJaillPS Ijnd Root. Roan 

IvRMdy T1 

Q TREtCUCPP 

! Pfopifft 

' V Rfrtng ! 

■ § TREEXRC 


]v»».v 


aiONUSDOC doo^rt 

I3# Rwmitt QHH 

D~UR jCWT do: ~ Qjyj 


SftTree Tree Control 

From simple listbox with bitmaps to multi- 
line, multi-column, hierarchical data display, 
SftTree delivers! This 16-bit and 32-bit 
OCX control supports most popular 
environments including VB. Delphi, Access, 
etc. Also available as a DLL-based control 
for C and C++. 


Tfof i ntfz/i wMfuil 

Nor The Industry Standard 

11 Michigan Ave 
Wharton, NJ 07885 


Call today 
for your 
free demo! 


SftTabs 
Tab Control 

This DLL-based custom 
control supports C, C++ 
(MFC, OWL). Windows 
3.1, Windows NT and 
Windows 95 with over 50 
different tab styles! 

Add tab controls to your 
16-bit and 32-bit 
applications with this easy 
to use tab control! 


(201)366-9618 
FAX (201) 366-3984 
http://www.softelvdm.com 


X.25, LAP-B, HDLC/SDLC, 
Bisync, Async & custom protocols 

Use Qrndron communications development 
took for IBM ARTIC realtime 
co-processor cards. 


Ouadron 

209 East Victoria 5 


Multiple protocols run on a card 
High-level C-Ianguage API 

Multiple ports, high data rates 209 East victoria street 

Windows, DOS, A1X& OS/2 ^SfI 

„ \v. fax oUD-yoo-/boo 

Easy-to-install, easy-to-use telephone 805-966-6424 

Accelerated time to market. http://www.rain.org/-quadron/Q.htmi 

0 1996 QuaJiofi Service Ccrp. Ihtdemarks are the property <rf (heir owners. 
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Apis Software GmbH 

BolongarostraBe 113, D-65929 Frankfurt 
Tel:+49 (0)69-31 40 23-0 
Fax: +49(0)69-31 40 23-23 
Email: 100145,3415 @compuserve 
CompuServe CIS-ID: 100145,3415 


herCules: 

the portable “C" database system for most operating systems with source. 
herCtlles supports OS/2, Windows 3+, Windows NT, DOS, UNIX, AIX, 
QNX...and the database, memos and index formats of dBase III, IV, Clipper as 
well as Foxbase. herCules is available as network or client/server version. 
Important features: 

• C++ Interface • Report Generator 

• SQL Interface • Full source code 

Manuals available either in english or german. 
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Announcing another great game 
written with 

Fastgraph® 

Programmer's Graphics Library 


Larry Hess has completed DOS and Windows versions of 

Catfight by Atlantean Interactive Games 

The ultimate all-female fighting game. Experience the thrill of total 
carnage with Catfight. Experience the advantage of multi-platform 
releases with Fastgraph for DOS and Fastgraph for Windows. 

Now available for Windows, only $249 / DOS: $249 

Ted Gruber Software Voice (702) 735-980 1 

PO Box 13408 FAX (702) 735-4603 1 

Las Vegas , NV 89112 BBS (702) 796-7134 1 

Visit our web page at www.fastgraph.com 
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▼ ^ 0vv 4va,7 ."’.I 

You’ve got questions-the ^ ev rsstan7i e ^ 
Dr. Dobb’s Sourcebook 
Series has your answersl 

Each issue is packed with professionally-crafted, immedi¬ 
ately usable source code and all the time-saving advice 
you expect from a Dr. Dobb’s publication! Each issue fea¬ 
tures the advice of our renowned columnists: 


Windows 

SfcsM,' 


• Al Williams 

• Michael Abrash 


• Allen Molub 

• Plus Software and the Law 


Programming 


3 mum tAM 4 . 0 , 

• • “ icn iin pm, 


| Pick up yours today! 

I Order These Back Issues While Supplies Last 


Windows Programming 
March/April *95 (V20/14) 
Games Programming 
May/June’95 (Y20 r #l 4) 
C/C++ Programming 
July/Augusf '95 (V20,#15) 
PowerPC Programming 
September/Ocfober '95 
(V20/16) 

Internet & WWW 
Development 
November/December *95 
(V20,#17) 

Database Programming 

January/Februory '96 
(V21,#13) 


To order, 

. CALL: 800-444-4881 
. INTERNATIONAL ORDERS: 

Call 913-841-1631 

• FAX: 913-841-2624 

• E-MAIL hvessichelli@mfi.com 

• MAIL TO: 

Dr. Dobb's Sourcebook 
1601 West 23rd St., Ste. 200 
Lawrence, KS 66046-2700 USA 

Ordering Details: Include your name, oddress, city, state, lip, and country. 
Price is $10.00 for USA/Canada; all other countries $1 S.00. Price includes 
shipping. Include issue name, date and volume number. Please odd sales tax 
in the following states; CA (8.5%), GA (6%), 11(6.25%), KS (6.9%), NY 
(8.25%), TX (8.25%). We occept all major credit cords or Checks/Money 
Orders in US funds drawn on a US bank. 


Enhance Your Applications 
with Postalsoft Technology 


»Address correction 

• Postal coding 

»Postal presorting 

• Postal barcoding 

• Label generation 



• Electronic image 
processing 


Forms Processing 


1 Directory Retrieval 
Systems for OCR/ICR 
engines 


• Name standardization 

• Address standardization 

• Address correction 

• Duplicate detection 

• Merge/purge 

• List conversion 

• List management 


The best software tools available for 
OEMs and in-house developers! 

•add the features your users are demanding 
•save costly development time and resources 
•integrate with ease - development tools written in C 
•choose from library or batch products to fit your needs 


POSTALSOFT 

With IWrfvrmtuice Software Sytums 


Http://www.postalsoft.com 


Call today, 1-800-831-6245 
to find out why leading OEM 
and corporate developers 
choose Postalsoft tools 
for their applications 


CIRCLE NO. 614 ON READER SERVICE CARD 

















































IBLY 


DEVELOPMENT TOOLS E 


Pentium® Processor Optimizer 

I Our software automatically annotates your assembly source with I 
Pentium® processor optimization information (simulated pipeline 
pairing, AGI's, prefix stalls, register trace and more). Reports sta¬ 
tistics by loop nesting depth. ($199.95) ASMFLOW generates 
flow charts, free diagrams, register analysis, x-ref, timing info and 
more-for 80x86, 8051, 8096, Z-80, 68HC11, 68HC05, and 
more. ($199.95) Call for free demo and catalog of assembly, TSR 
and floating point libraries. ($99.95 to $299.95) 

| Pentium is a registered trademark of Intel. 

Quantasm Corp. 

19672 Stevens Creek Blvd #307-D 
Cupertino, CA 95014 
800-765-8086 or 408-244-6826 
FAX: 408-244-7268 
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BOOKS 


Beginning Linux Programming 

a Unix programming step by step 
a Code tested on Linux-FT, the 
POSIX.1 certified Linux 
a Covers X-Windows programming 
a Develop Tcl/Tk applications 
a Explains sockets programming 
a Build bullet-proof CGI apps with C 

ISBN 1-874416-68-0 Author Matthew & Stones $36.95 

Available at all leading Visa Mastercard AMEX Dtscovw 

bookstores, or order efired- Quote code CL66 tor freo freight 

3WKS=S2Sr 

(our fulfillment agent) 


- 800-937-5557 
.. 800-PRI-ORDER 


312-46&OS69. 

http-iWww.vyroxxonV 
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C++ LI BRAKES _ 

M++ Version 5.1 
Complete C++ Math Library 

•UNPACK and EISPACK classes 
•Complete signal processing suite 
•Multidimensional array language with 
generalized inner and outer operations 
I •Persistent arrays 

| ‘Extensive set of mathematical functions 
•Advanced functionality provided by optional 
modules 

l)yad Software Corporation 
6947 Coal Creek Pkwy SE #361, Newcastle WA 98059 
206-637-9426 or http://www.wolfenet.com/~dyad 
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CDROMs 


Call Now! 1-800-786-9907 


Official Linux Slackware ’96 $39.95* 

Internet’s favorite operating sys. Full PC Unix. 4 discs. 
FreeBSD 2.1 + FREE Book $39.95* 

Full 4.4 BSD Lite-based 32-bit operating sys. 2 discs. 
Blackhawk ’95 $29.95* I 

Latest Windows 95 shareware, utilities, app’s, access. [ 
CICA MS Windows $29.95* | 

3,500 Windows prog, freeware, demos, drivers, utili. 
Newt for Windows NT $39.95* | 

NT shareware, utilities, prog, tools, patches, & more. 
Hobbes OS/2 Archived $29.95* 

OS/2 mag’s product of the year. 1000 MB shareware. 
Perl $39.95 

Latest edition packed w/ Perl source code, docs, more 
The Viper Toolkit $39.95 

850 files for visual prog in Visual Basic. C/C++, etc. 
Command & ConquerAVarcraft 2 Toolkit $19.95 
Add-ons & new levels for these hottest selling games. 

* Call about our subscription offer where $29.95 discs arc 
$19.95, and $39.95 discs are $29.95. 

""All <>i^'0>l]ipping $5 in US A/S9 Overseas Per Order 

.n.rn.ROMs \ |_ J lesffll&Sill 

C unconditionally i 

^mntred^ / Walnut Creek CDROM 

Phone: +1-510-674-0783 • Fax: +1-510-674-0821 
Email: orders@cdrom.com • http://ww w.cdrom.com/ 
4041 Pike Lane. Ste D-395, Concord CA 94520 

Call for your FREE catalog today! I 
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_JNICATIONS_ 

16 & 32 bit Serial Comm Libraries 1 

I Personal Communications Library Supports 20 ports 

to 115200 baud, 16 & 32 bit DPMI, multiport dumb cards 
(Digiboard, BOCA), any IRQ & UART address, interrupt driven, 
HW flow control, 16550 UART & modem AT commands. Source 

code included. Specify C/C++ (Win or DOS). Turbo Pascal 

| (DOS), Visual Basic (Win or DOS), or PowerBASIC (DOS). 

$75 + s&h includes manuals & one year support. Get FREE 

shareware version form our BBS or ftp.marshallsoft.com. 

| Visit our home page at www.marshallsoft.com. 

MarshallSoft Computing, Inc. 

P.O. Box 4543, Huntsville, AL 35815 
email: info@marshallsoft.com 
(205) 881-4630 Voice, 880-0925 FAX, 880-9748 BBS 
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Tbe McCabe 00 ToolSet™ 

The McCabe Object-Oriented ToelSet™ is the newest addition to the 
McCabe ToolSet™. It provides a wide variety of system metrics and a clear 
visualization of 00 applications architecture. C++ systems can be fully 
tested and SAFE and UNSAFE classes identified. To reduce redundancy, 
the tool finds reusable code throughout a system. In addition, it contains 
features that help migrate systems from traditional languages to 00. The 
McCabe ToolSet is also available for over 25 traditional languages and 

ditledi ' Wt 

Uncover Your Software McCabe 

Associates® | 

| For Furthor Information Call 800-638-6316 or Fax 410-995-1528 
http://www.mccabe.com 
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m 


Dr. DeeBee O 


The easiest way to 
create art ODBC driver 



Connect your proprietary database to the 
world’s most popular database tools such 
as Access, Visual Basic, PowerBuilder, and 
Crystal Reports._ 

Dr. DeeBee I * * * * * * * 9 
ODBC Tools 

Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


- G17-497-1376 

Fax 617-497-8729 
http://www.syware.com 



-syvwoE *— 

P.O. Box 91 Kendall 
Cambridge, MA 02142 
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UNIVtRSRl CD-ROM 




UNUX with X, C/C++ TCP/IP, 
Internal and Sourca Coctet 

Only $17 and up! 


SCSI FOOGQAMMNC SOURCE ON CD ROMP 

IOC C* DO. 1-5 XXKHtl tCAMCS (cotto IXVWb) I 
O AJ MM Oak CD POM 101 OR 
O Al MOM4CAC CO COM I n on 

Humorous currant programming CD-ROMs avaJIabte... 

Unix, Window*. NT. OS/2. DOS. Internal. WWW. HTML. TCP/IP. VR, 

30. Moc. Mpag. Motlff. X-Wlndow». ASD. C/C++. dBoso. Dr. Dobb't 
Journal. Part. GNU. Unux. TEX. Tcl/Tk. CICA. Standard AL NaXI. 

Ado. Cllppar. and many more with tourca coda! 


1500 Muon* &‘D'± ; 

° Games/Enterahment 
* Education/References 

% Sound/Video/Art __ r _ 

o Programming/Engineering 

O Arii I If Imol ucrat>lgma«.com 

| « nOU/l MU; http//www btgmaI com 


»*» wortefendo from Me on Vcdoy 
Accept chad money ante or cnk* 
VWt our totomot hamopago. lor cun 
hi and price 
UNP/tttAl CD-tOM 
*20 lawronce Exp. 1307 
- * TAtJOMcMT" 


CAN PARSING BE FUN AND EASY? 

Parsing input used to mean tricky logic with lots 
of places for bugs to hide, slipped schedules, 
difficult maintenance. Nobody’s idea of fun. 

Now, AnaGram changes all that. You can take 
charge and concentrate on the real problems. 
Expressions? Database queries? Scripts? A 
command language? No problem. It’s fun, it’s 
easy. See why developers the world over are 
turning to AnaGram. Call for free trial copy. 

Anagram * by Parsifal Software 
P.O. Box 219, Way land, MA 01778 


(800) 879- 2577 
CIS: 72603,1763 


Voice/Fax (508) 358-2564 
jholland@world.std.com 


Boost your Basic! 

Develop your app faster Get TeraTech 
tools! 36 VB, QB. PB. C & Xbase libraries 
available. Call us and well mail you a 
free demo & booklet ASAP. Call now! 

rnrr J 

* DazzJe/VB - images rfxrr fl 
*VBIite♦ print/corrm • l\L.L U 

* ProMath/VB • numerics 

* FinLib/VB - financial * ProBas - & other 15 DOS libs 

* QuickLine/VB - telephony * VB training - 2 day intro dass 
ISpdJCheck/VB - spelling * Custom - C, ASM.'VB programming 
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800 - 447-9120 ext.i 179 

Dept 1179,100 Park Avenue. Suite 360, Rockville MD 20850 
lnfl:+1-301-424-3903 Fax:301-762-8185 BBS:301-762-8184 
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^Tevic^rlver^^ 

International 

Device Drivers For: 

Windows '95, 3.x, NT 
DOS, Embedded 

Specializing In: 

Rapid Development 

High Speed Execution 
High Reliability 

. Sherman R. Couch 
^ 513-777-8895 

Ohio 

Anthony A. Kempka . 
307-721-4881 
Wyoming 


;raphics libraries 


★ ★★★ ★ 


IBRARIEi 
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( EDITOR 

Win-Emacs 

The Complete XEmacs Editor 
for Microsoft Windows® 

NEW! 32 -bit version 
for NT/Win95/Win 3.1 

To Order Call 1-800-WIN-EMACS 
Pearl Software Corporation 

Tel: 510-652-4361 • Fax: 510-652-4362 

http://www.pearlsoft.com/ 
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EDUCATION 


B.S. & M.S. 

In Computer Science 


•ALL COURSES HOME STUDY 
•Approved for tuition reimbursement 
by leading corporations 

• Increase your earning power 
•C++, Using Windows, and Ada 

courses available 

• CareerPa//? training in computer 
programming available 

For free Information call: 
1-800-767-AICS 


AMERICAN 

INSTITUTE 

COMPUTER 

SCIENCES 


ACCREDITED MEMBER 
World Autxiatm of 
Univtnitia end ColUfts 


File encryption so strong, 

us export it. 
_TM 


S the feds won’t let us 

.ycarrick 

[j Industrial strength encryption based 
on the Blowfish algorithm. 

i 8oo ENCRYPT www.encryption.com 


VICTOR 


Image Processing Library 

Fast BMP, TIFF, PCX, GIF.TGA, JPEG. Adjust brightness, 
contrast, sharpen, create filters, resize, rotate, +more of sin¬ 
gle image, multiple images, or any image area; color reduc¬ 
tion to optimum, specific, or std. palette: print: scan; crop, 
combine, compare, blend images. EGA, VGA, SVGA. 

DOS $199,16-bit DLL $299, 32-bit DLL $499 

Catenary Systems 
314-962-7833/fax: 314-962-8037 
www.catenary.com/victor 
ask for free demo src avail visa/mc/c.o.d. 
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ILIB Imaging Libraries 

I Inventions is proud to announce that ILIB is now available 
I on Windows 95/NT. 

| ILIB offers unsurpassed imaging technology, including: 

• Industrial standard software 

• Full 32 bit open architecture on Wm95 and Win NT 

• Parallel processing on C40 and T9 hardware 

• Outstanding functionality and speed 

• Modular format: 

ILIB—image processing 
ILIB—image analysis 
ILIB—advanced imaging techniques 

(neural imaging, smart filters, 
fuzzy logic, pattern recognition) 
Phone/fax: Inventions Ltd. (UK) +44(0)161 973 3047. 
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WINGRAF2.0 

I (Win 3.1, Win95. WinNT) 


INGRAF 7.0 

(DOS/DOS extenders) 


WINGRAF & INGRAF are Graphics libraries for 
Scientific, Engineering and Business applications. 
Each library contains over 150 routines to on 
VIDEO, PRINTERS and PLOTTERS. 

C, PASCAL, DELPHI, BASIC, and FORTRAN 
versions. NO ROYALTIES, FULL SOURCE 

Sutrasoft p.o. box 1733 

Sugar Land, TX 77487-1733 
TEL: (713) 491-2088 FAX: (713) 240-6883 
76163.1164@COMPUSERVE.COM 
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EPS-View 

support .EPS, .Al, .PS files 
EpsView DLL interprets PostScript 
command of EPS, Al, PS files and 
-Display -Printing 

-Converting to .PCX 
16-bit DLL $450, 32-bit DLL $650 
(up to 2,000 copies) 

D4 Soft Inc. 

212.947.2690 212.760.0754 
fax 212.695.5939 


CIRCLE NO. 513 ON READER SERVICE CARD CIRCLE NO. 518 ON READER SERVICE CARD 

The SPINDRIFT library Version 3.0 T^b^WeeM^T^WensAon 


The Complete FORTRAN Programmer's Toolkit. 

I Create sophisticated state-of-the-art user interfaces for your FORTRAN 
I programs. Spindrift's callable subroutines and functions let you 
• Have dota entry screens, dialog boxes, scrolling list boxes, 
pull-down menus, push buttons, help panels, etc. All with full 
mouse support. 

» Much more! 261 subroutines and functions for keyboard, 
screen, mouse, DOS control, and hardware status. 

| Comprehensive demonstration program shows what you can do and how to do it. | 
Now shipping Version 3.0 with all new User Guide. 

PRICE: 16 Bit Compilers - $149 32 Bit Compilers - $289 

I Spindrift Laboratories, Ltd. 

1 116 South Harvard Avenue • Arlington Heights • IL 6000S • USA | 
I Phone: (847) 255-6909 • FAX: (847) 255-6101 


0 The only MFC extension class library 
that delivers new class(es) each week 
0 Updated through Internet e-mail 
0 Includes all classes available upon 
subscription : GRTD: JPEG; MAPI:... 
0 Free sample classes available as demo 
0 Only $249 annual subscription 


Contact 
or visit 
Periphere 


Phone: 303-682-5297 
Fax: 303-772-9130 

eMail: info" peripherc.com 
http://www.pcriphere.com 


Add ZIP (and UNZIP too!) to 
your Windows applications! 


rnaZIP 3.0 Data Compression | 

I The new ROYALTY-FREE DynaZIP family of developer's toots let I 
you odd ZIP and UNZIP capabilities to your Windows I 
applications. No more ‘shelling* to DOS, no more fussing with I 
proprietary compression formats. DLLs, VBXs, OCXs and a I 
new database Interface provide full access from many I 
languages. Fast, reliable, and easy to use! 16 and 32 bit I 
versions, supports tong filenames. 

Fully supported, 30-day no-rlsk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media. Inc . Hollis NH USA (6031 465-3216. tax (603) 465-7195 
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SPELL CHECKING & THESAURUS 


MULTI-LINGUAL 

I Danish Dutch French German Italian 

| Norwegian Spanish Swedish UK English US EnglishW 

I FIRST CLASS ■ AFFORDABLE ■ ROYALTY-FREE | 

■ FAST-EASY-POWERFUL 
■ U.S. ENGLISH THESAURUS TOOLKIT TOO! 
AVAILABLE FOR DOS, WIN 3.1, WIN NT, WIN 95, OS/2 
LexSaurus Software, Inc. 

427-3 Amherst St. Suite 303, Nashua, NH 03063 
(603) 672-5941 • 1-800-570-1984 • Fax: (603) 672-5934 
_ E-mail: into@lexsaurus.mv.com 


DOWNLOAD OUR FREE DEMO ! 
http://www.mv.com/ipusers/lexsaurus 
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- Intelligent 

Components ... 

... that solve problems, deduce configura- 
tions. monitor processes, assess situa¬ 
tions , (jive sage advice and schedule events 
in any Windows tool or language. includ¬ 
ing web servers. U2 ami Ki-hit develop¬ 
ment tools & I)IJ,s. FREE CATALOG 

•. 40 Samuel Prescott • Stow, MA 01775 

tel 508-897-7332 • fax 508-897-2784 
1 \»* c " info@amzi.com • http://www.amzi.com 
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SECURITY 


I EVERLOCK Safe-D EVERKEY 

Internet/CD-Rom Activation 


CPU-l/>ck * HDD-Loek 


129 


Registration * Date & Execution Limits 
Serialization * Network Limits 
Windows 95 * 3.11 * DOS 

Az-Tech Software, Inc. 

Leaders in Software Security 

[ Phone: (816) 776-2700 * Lax (816) 776-8398 
I nternet: h ttp://w\vw,.az-tech.com 
E-Mail: sales@az-tcch.com 'HI 


| Powerful Protection, Affordable Price ] 

Software Security’s UniKey® Anti-Piracy System 

DOS/Windows/95/NT/Unix/1 
NetWare support 
Time/date-based execution | 
control 

Made in U.S.A. 

Call now and order your I 
UniKey Developer’s Kit: 

800-841-1316 

6 Thomdal Circle, Darien, CT 
06820-5421 (203)656-3000 
http://www.softsec.com 


• Reliable hardware key 

• Secure protection for multiple 
applications/versions 

• The industry’s only patented 
protection technology 

• Protects applications quickly, 
without programming 

• Remote update capabilities 

SOFTWARE /y ^L 

SECURITY K_' 
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Suite 2027. Atlanta. GA 30329 ^ 
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MX 


22 Eie:.: .e r:-. 


NfaBUnONM NG 


Horae Pase 


The Marx CRYPTO-BOX is the result of 
over 10 years experience in effective 
software protection. 

• microprocessor controls ID codes, 
memory, dynamic algorithm and 
high speed data encryption 

• remote access to passwords and counters 

• license metering in networks: single key per LAN^ 

4M-321-302U FAX: 4W-321-0760 
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Reach over 

116,000 

professional software developers for 
just pennies per lead with your ad in the 
Marketplace. 

For more info, call Cheryl Canion 

415.655.4182 or email: ccanion@mfi.com 


SECURITY 


CrypKey Software Licensing System 

'Software Copy Protection with NO Hardware Key and NO Disk Key' 
CrypKey is a software copy protection that is 

• compEetety secure from *ny disk copy program 

• compMefy compatible with any MSDOS. MS WINDOWS, W1N9S, WIN NT 

• completely compatible with CD-ROM, BBS, or Internet distribution! 

• customer friendly • no disk key, no hardware key, less support calls 
CrypKey can Increase your software sales by allowing you to sell your program 

• by increments—sell add-on software options or levels to your customers 

• by number of runs—e g. sell 100 calculations lor $100.00 

• by time period—e.g, lease or demo your program for 60 days 

CrypKey uses a numeric key that can be transmitted by phone, 
fax,or email. Sell your customers more options, more copies, more 
time or more runs instantly, just by making a telephone call (great 
for overseas customers or distributors). CrypKey is produced by 
Kenonic Controls Ltd.—engineering and software since 1972 

Kenonlc Controls Limited 

717S • 12th Street South Lest 
Calgary, Alberta, Canada T2H 2S6 
(403) 258 6200 fax: (403) 258 6201 
INTERNET: crypkeyekenonlc.com 


TOOLS 


C and C++ DOCUMENTATION TOOLS (v. 6.0) 


• C-CALL ($69) Graphic-tree ol caller/called function hierarchy, cross-ieterence. 
file/function Index. 

• C-CMT ($69) Crcates/mserts/updates comment-blocks (functions/identifiers 
used) lor each lunction. 

• C-METRIC ($59) Calculates path complexity, counts lines with comments, code. 
*C‘ statements 

• C-UST ($69) Lists and action-diagrams, or reformats source Into user-selected 
standard formats. 

• C-REF ($69) Creates cross-reference of local/gtobal/define/parameter Identifiers. 

• C-DOC ($199) PACKAGE AH 5 programs integrated as DOS program <10.000 
lines. V6 0 C-BROWSE W indow s graphic-tree viewer. 

• C-DOC Professional ($299) DOS. Windows. OS/2.3-rmg binder/case 
Processes 1.000.000* tines. 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way. Mississauga Voice/Fax (905) 858-4466 
ONT Canada L5N-4M1 http://swbs.idirect.com 


TRAINING 


Learn about: 

• Java applets & applications 

• Java development tools 

• The Java language 


August 5-6 
August 7-9 
August 19-20 
August 21-23 
September 4-6 


CALL NOW: 800.717.5475 

Phone: 617.621.0060 Fax: 617.621.9555 
E-mail: training®i6s.com WWW: http://www.ics.com/ 


ICS 


Integrated Computer 
Solutions Incorporated 


DR.DOBB’SWEB DIRECTORY 





DOCUMENTATION TOOLS 


, QualSoft 


liWiitM.rarcaa 

PURE SOFTWARE 

http://www.pure.com 

RISTANOVIC 


'http ://www.qsoft.com 

/ Download George to automatically document your source code! Best of 19951 MKS 
Code & Source Integrity, XFaceMaker, NuTCRACKER, XRT, Olectra! 




EMBEDDED SYSTEMS 


WIND RIVER SYSTEMS 

http://www.wrs.com 



http://www.ristanovic.ch/da 



A, w INTEL 


INFOMAGIC 


http://www.infomagic.com 


CONSULTATION/SYSTEMS INTEGRATOR 


UNIPLAN 


http://www.intel.com/ial/vtune/index/html ^ 

INTERACTIVE SOFTWARE ENGINEERING 
http://www.eiffel.com 


http://www.uniplan.it 



n* 


SYMANTEC 


CROSS PLATFORM/GUI DEV. TOOLS 



SOFTEL VDM 


http://www.softelvdm.com 



http://www.careermosaic.com/ 

cm/symantec/home.html 


UTILITIES 


GAMELON by MENAI 

http://www.menai.com/ 


NuMEGA 


http://www.numega.com/ 


For information on advertising your web site, call Cheryl Canion at ( 415 ) 655-4182 or email: ccanion@mr.com 
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SWAINE'S FLAMES 


Interrupt Mode 


I f you haven’t read the roundtable discussion on the theme “Is Microsoft Evil?” in the first issue 
of Slate, I’ll wait while you go do that. It should be at http://www.slate.com/, in the Compost. 
While they’re away, I’ll give the rest of you a preview of the musical I’m writing, based on 
My Fair Lady. It recounts the hilarious attempts of a world-famous linguist to teach a Newton 
MessagePad to read proper English, and it has lots of great songs, like “I’ve Grown 
Accustomed to Her Interface,” “I Could Have Scrolled All Night,” and “The Rain in Spam Stays 
Manila in the Islam. ” 

Just then, the door flew open and my cousin Corbett walked in. “Table the Islam,” he told me. 
“I need some advice on existentialism.” 

“Shoot,” I said, hiding the cookies. 

“Okay, now Sartre says that Hell is other people, right?” he asked, finding the cookies. “But in 
another place, he says that Hell is a long corridor of rooms decorated in Second Empire style.” 
“Sounds inconsistent to me, Corbett.” 

“Eifher fhat, or he meanf fhat ofher feofle are a corridor of roomf decorated in Fecond 
Emfire ftyle.” 

“It’s hard to understand you when you talk with your mouth full, but in my experience a long 
corridor of rooms decorated in Second Empire style...” 

[Monica—No, I didn’t make it up. I found that Second Empire quote on page 28 of the May 
1996 issue of France Today. 

Back already? Interesting stuff in a publication founded and funded by Microsoft, eh? James 
Gleick and James Fallows really pile on poor Steve Ballmer about the leaky Chinese wall between 
the OS and apps groups. Others get bashed, too: I liked that line of Fallows’ about “the flatliners 
running the company” at IBM. I’ll be watching to see if Slate can really retain its editorial 
integrity. As to its content... 

I’m sure you realize that what I’m doing here is playing with levels of interruption. You should 
have five topics on your mental stack now: Slate, My Fair PDA, Cousin Corbett, Monica, and this 
one: <a href=“http://www.cruzio.com/~mswaine/moreofcolumn”> 

That was six. 

</a> 

“...is the Magic Cap user interface.” 

You do get France Today, don’t you? You could probably expense it; it has a regular column 
called “Web Watch” about you know what.—Mike] 

Eliza, the heroine of the story, is the PDA’s handwriting-recognition software. Her namesake 
mother was a Rogerian therapist, but our Eliza supports herself and her “retired” sugar-water 
salesman father by working as an order-entry clerk and dreams “Wouldn’t It Be Loverly” il she 
could spell. 

...a fair amount of Slate's first issue consists of writing about writing and analysis of analysis. I 
fear that if I write about it here, it’ll just be writing about writing about writing and analysis of 
analysis of analysis. And who knows where that might lead? 

“Hell,” Sartre said, helping himself to my cookies, “is a stack crash.” 



Michael Swaine 

editor-at-large 

mswaine@cruzio.com 
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Now discover CodeBase 6.1 - The fastest and smallest 
database engine available with xBASE file compatibility! 


Query a million records in just 0.97 of a second, 
or add ten thousand records in just 2.17 seconds. 

Discover these valuable benefits of CodeBase: 

• C, C++, Visual Basic and Delphi are all supported. 

• FoxPro, Clipper and dBASE file compatible, 
and multi-user compatible 

• Runs under Windows 95, 3.1, NT, DOS, 
and UNIX 

• Tiny DLL loads quick and 
takes little memory 

• Transaction processing and logging 

• Client/Server configuration included 

• Crash recovery is built-in 

• Full featured report writer included 

• Source code included 

• Royalty Free-even with Client/Server 


SQL Option Available 

Now get the most database 
power at the lowest cost. 


A 799/* k a 7992 * A 1993 A ^ A 1994 a A 1995 a . 

DAIA BASED I DATA HASH) I DATA BASED I DATA BASED I DATA BASED I 

advisor| advisor| advisor| advisor| advisor| 

Readers Once/ fkadenChett/ Readers CMce/ 


Readers CXckxT 


Awxml-Wiimingperformance 5years in a row! 

“CodeBase gives ACT! the fast database access 
contact management users need” 

- Michael Plasterer, Director of Development, 

Symantec 



FREE 


Test Drive 


Test drive the new CodeBase 6.1 
for 30 days with your own code. 
No risk. No obligation. Order 
yours today. 

Call: 403-437-2410 


The Database Engine for Programmers 


SEQUITER 

SOFTWARE INC. 


Fax: 403-436-2999 
Email: into® sequiter.com 


PO Dai 575 Newmarket t*t 03857-0575 


Web site: www.sequiter.com 


01996 Sequter Software. Inc. A 1 rights reserved. CodeBase and Sequtor are trademarks of Soqurtor Software Inc. Al other product names are trademarks of therr respective companies. 
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Borland C++ 5.0 

Take advantage of the most productive 
C and C++ environment (included). 



CodeGuard 

Boost application quality with automatic 
bug detection and diagnosis (included). 




Borland C ++ 

Development Suite 

K targets Windows 3.1,95, NT, and DOS 


Internet programming with Java 

Get the best integrated Java“ development environment 
including a GUI debugger written in Java. Plus, 
get the App/lcce/erafor " to boost Java application and 
applet performance by up to ten times (included).* 


*j*j am jits) +iai m 


PVCS 

Manage your source code easily 
and safely with powerful PVCS 
version control (included). 


installShield Express 

Build your installation with point- 
and-click ease (included). 


Cut development time using the 
New Borland C ++ Development Suite 5.0 


The only comprehensive, integrated suite 

available. The new Borland 8 C++ Development 
Suite 5.0 was designed to speed your development. It 
is the only product to bring together four essential 
phases of the development process: coding, testing, 
version control, and install creation—all totally 
integrated for 32-bit Windows development. Plus, get 
integrated Java tools and AppAccelerator. 

Borland C++ 5.0—the most productivity on 
Windows 95/NT. The suite includes the complete 
Borland C++ 5.0, designed to bring state-of-the-art 
innovations in productivity to Windows 95/NT devel¬ 
opment. Borland C++ 5.0 features a new 32-bit 


hosted IDE, parallel 32- and 16-bit development from 
a single IDE. updated C++ support, updated OWL 
5.0 (with more than 150,000 lines of pretested 
reusable code), ObjectScripting, and MFC library 
compilation support. 

Powerful new ObjectScripting saves you time by 
automating your build process, integrating tools and 
utilities, and even adding new features and experts to 
facilitate compliance with corporate, team, or individ¬ 
ual standards. With ObjectScripting, the only limit to 
productivity is your imagination. 

CodeGuard 32/16 automatic bug detection. 

Use CodeGuarcT to detect, pinpoint, and diagnose 
elusive memory and resource bugs in 
your 32- and 16-bit Windows applica¬ 
tions without changing a single line of 
code. And by double-clicking on your 
error, CodeGuard will automatically take 
you to the offending line of code. 

Seamless PVCS Version Manager. 

Now PVCS version control comes built 
into your development environment. 
Check-in code, check-out code, retrieve 
old versions, visually compare changes in 
full color, and protect all of your work. 
Great for both solo and team-based code 
management. 

InstallShield® Express poinl-and- 
CllCk Install Creation. Use any of 


Compare the 

F a cJ-s 


Features supported 

Borland C.« 
Dentlopmtnl 
Suit* SO 

coital 

c~ 

so 

Vitoal 

4.0 

Complete support for Windows 95/NT 

✓ 

✓ 

✓ 

Parallel 32-bit and 16-bit development 

✓ 

✓ 

— 

ObjectScripting (fully programmable IDE) 

✓ 

✓ 

— 

Visual database development 

✓ 

✓ 

— 

OCX container support 

✓ 

✓ 

✓ 

VBX support for both 32- and 16-bit applications 

✓ 

✓ 

— 

FREE Java tools for the Internet, including GUI debugger 

✓ 

✓ 

— 

Windows 95 controls supported under Windows 3.1 

✓ 

✓ 

— 

MFC compilation support 

✓ 

✓ 

✓ 

ANSI/ISO Standard C++ Library, including STL 

✓ 

✓ 

— 

Integrated 32-bit debugging and resource editing 

✓ 

✓ 

✓ 

Point-and-click install expert with prebuilt components 

✓ 

— 

— 

Automatic uninstall support for Windows 95 

✓ 

— 

— 

Detects bad pointers, even outside of API calls 

✓ 

— 

— 

| Automatic detection, location, and diagnosis of memory bugs ✓ 

— 

— 

1 Full color visual differencing of source code versions 

✓ 

— 

— 

Label and maintain source files for beta, release, etc. versions ✓ 

— 

— 

App Accelerator for up to ten times faster Java code 

✓ 

— 

— 


Egghead Software CompUSA Computer City Programmers’ Shop 

1 -800-555-5555 1 -800-COMPUSA 1 -800-THECITY 1 -800-421 -8006 


13 prebuilt dialog boxes. Visually build disks, test 
installation, add uninstall functionality, and create a 
distribution master. 

Find out how much more productive you can be 
with a suite. 



Get FREE update to Borland C++ 5.0- 
now includes MFC. 

PLUS, create your own Web site 
with free DeltaPoint Quicksite. 

Check out Borland Online to find out more 
about MFC and new BC++ Development Suite 
with Design Tools 5.0. 

hUpV/wwwJiorland.com 

Or for more information call 

1-800-336-6464, ext. 50595 

CompuServe: GO BORLAND ■ Canada: 1-800-461-3327 


Borland 


Making Development Easier 


CIRCLE NO. 67 ON READER SERVICE CARD 


‘Free for a limited time. 'Competitive product owners upgrade price. Java is a trademark of Sun Microsystems. Inc., and refers to Sun’s Java programming language. 

Copyright 0 1996 Borland International. Inc. All rights reserved. All Borland product names are trademarks of Borland International, Inc. Prices good in the United States and Canada only. All prices arc in U.S. dollars. BI 8727.1 

















































































































































